SPECIFICATION 



TO ALL WHOM IT MAY CONCERN: 

Be it known that we, Mark Lucovsky, Sam George, Bill Hoffman, Jay Jacobs and Paul 
Steckler have invented a certain new and useful SCHEMA-BASED SERVICES FOR 
IDENTITY-BASED ACCESS TO INBOX DATA of which the following is a specification. 
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5 The present application claims priority from co-pending United States provisional 

application serial number60/275,809, filed March 14, 2001 and entitled "Identity-Based 
Service Communication Using XML Messaging Interfaces", which is hereby incorporated 
herein by reference in its entirety^ The present application is related to United States Patent 

Application serial number \ entitled Schema-Based Services for Identity-Based Data 

q 10 Access, filed concurrently herewith on October 22, 2001. 
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/W >COP¥RIGIIT DISCLA IMER 

A portion of the disclosure of this patent document contains material that is subject to 
copyright protection. The copyright owner has no objection to the facsimile reproduction by 



13 1 5 anyone of the patent document or the patent disclosure as it appears in the Patent and 



Trademark Office patent file or records, but otherwise reserves all copyright rights whatsoever. 

f^ > FIELD OF THE INVE NTION 

The invention relates generally to computer network data access, and more particularly 
20 to systems, methods and data structures for accessing data and data-related services over a 
network. 
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BACKGROUND OF TIIE INVENTIO N 

There are many types of data that users need to manage and otherwise access. For 
example, users keep word processing documents, spreadsheet documents, calendars, telephone 
numbers and addresses, e-mail messages, financial information and so on. In general, users 
5 maintain this information on various personal computers, hand-held computers, pocket-sized 
computers, personal digital assistants, mobile phones and other electronic devices. In most 
cases, a user's data on one device is not accessible to another device, without some manual 
synchronization process or the like to exchange the data, which is cumbersome. Moreover, 
I j_ some devices do not readily allow for synchronization. For example, if a user leaves his cell 

b 

13 10 phone at work, he has no way to get his stored phone numbers off the cell phone when at 
H home, even if the user has a computing device or similar cell phone at his disposal. As is 



evident, these drawbacks result from the separate devices each containing their own data. 



I u Corporate networks and the like can provide users with remote access to some of their 

O 

f jj data, but many users do not have access to such a network. For many of those that have 



Q 15 access, connecting to a network with the many different types of devices, assuming such 
devices can even connect to a network, can be a complex or overwhelming problem. 

Moreover, even if a user has centrally stored data, the user needs the correct type of 
device running the appropriate application program to access that data. For example, a user 
with a PDA that maintains a user's inbox (e.g., received and sent items and so on) with a 
20 simple email application program ordinarily will not be able to use that program to open inbox 
information stored by another application program or the like at work. In general, this is 
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because the data is formatted and accessed according to the way the application program 
wants it to be formatted. 

What is needed is a model wherein data is centrally stored for users, with a set of 
services that control access to the data with defined methods, regardless of the application 
program and/or device. 



Briefly, the present invention provides an inbox service for central (e.g., Internet) 
access to per-user contact data, based on each user's identity, wherein the Inbox service 
includes a schema that defines rules and a structure for the data, and also includes methods that 
provide access to the data in a defined way. Because the structure of the data is defined from 
the perspective of the data, not from that of an application program or a device, programs can 
communicate with the services to access the data, with existing knowledge of the format. In 
one implementation, the Inbox schemas are arranged as XML documents, and the services 
provide methods that control access to the data based on the requesting user's identification, 
defined role and scope for that role. In this way, data can be accessed by its owner, and shared 
to an extent determined by the owner. Extensibility is defined into the schema. 

Other benefits and advantages will become apparent from the following detailed 
description when taken in conjunction with the drawings, in which: 
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^- WHE F DESCRIPTION OF TOE DM WING S 

FIGURE 1 is a block diagram representing an exemplary computer system into which 
the present invention may be incorporated; 

FIG. 2 is a block diagram representing a generic data access model in accordance with 
5 one aspect of the present invention; 

FIG 3 is a representation of services for identity-based data access in accordance with 
one aspect of the present invention; and 

FIG. 4 is a block diagram representing a schema-based service for accessing data 

m arranged in a logical content document based on a defined schema for that service in 

P 

Q 10 accordance with one aspect of the present invention. 
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j dt KQ^ yEXEMF LARY OPERATING ENWRO XMENT 
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fy FIGURE 1 illustrates an example of a suitable computing system environment 100 on 

ft! 

13 15 which the invention may be implemented. The computing system environment 100 is only one 

I* 

example of a suitable computing environment and is not intended to suggest any limitation as 
to the scope of use or functionality of the invention. Neither should the computing 
environment 100 be interpreted as having any dependency or requirement relating to any one 
or combination of components illustrated in the exemplary operating environment 100. 
20 The invention is operational with numerous other general purpose or special purpose 

computing system environments or configurations. Examples of well known computing 
systems, environments, and/or configurations that may be suitable for use with the invention 




DETAILED DESCRIPTI ON 
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include, but are not limited to: personal computers, server computers, hand-held or laptop 
devices, tablet devices, multiprocessor systems, microprocessor-based systems, set top boxes, 
programmable consumer electronics, network PCs, minicomputers, mainframe computers, 
distributed computing environments that include any of the above systems or devices, and the 
5 like. 

The invention may be described in the general context of computer-executable 
instructions, such as program modules, being executed by a computer. Generally, program 
modules include routines, programs, objects, components, data structures, and so forth, that 
perform particular tasks or implement particular abstract data types. The invention may also 

10 be practiced in distributed computing environments where tasks are performed by remote 
processing devices that are linked through a communications network. In a distributed 
computing environment, program modules may be located in local and/or remote computer 
storage media including memory storage devices. 

With reference to FIG. 1, an exemplary system for implementing the invention includes 

15 a general purpose computing device in the form of a computer 1 10. Components of the 
computer 110 may include, but are not limited to, a processing unit 120, a system memory 
130, and a system bus 121 that couples various system components including the system 
memory to the processing unit 120. The system bus 121 may be any of several types of bus 
structures including a memory bus or memory controller, a peripheral bus, and a local bus 

20 using any of a variety of bus architectures. By way of example, and not limitation, such 

architectures include Industry Standard Architecture (ISA) bus, Micro Channel Architecture 



(MCA) bus, Enhanced ISA (EISA) bus, Video Electronics Standards Association (VESA) 
local bus, and Peripheral Component Interconnect (PCI) bus also known as Mezzanine bus. 

The computer 110 typically includes a variety of computer-readable media. Computer- 
readable media can be any available media that can be accessed by the computer 1 10 and 
5 includes both volatile and nonvolatile media, and removable and non-removable media. By 
way of example, and not limitation, computer-readable media may comprise computer storage 
media and communication media. Computer storage media includes both volatile and 
nonvolatile, removable and non-removable media implemented in any method or technology 
for storage of information such as computer-readable instructions, data structures, program 

q 

p 10 modules or other data. Computer storage media includes, but is not limited to, RAM, ROM, 

ru 

}<* EEPROM, flash memory or other memory technology, CD-ROM, digital versatile disks 

Iff 

tn (DVD) or other optical disk storage, magnetic cassettes, magnetic tape, magnetic disk storage 

sy 

J or other magnetic storage devices, or any other medium which can be used to store the desired 

o 

iy information and which can accessed by the computer 110. Communication media typically 

ru 

p 15 embodies computer-readable instructions, data structures, program modules or other data in a 
modulated data signal such as a carrier wave or other transport mechanism and includes any 
information delivery media. The term "modulated data signal" means a signal that has one or 
more of its characteristics set or changed in such a manner as to encode information in the 
signal. By way of example, and not limitation, communication media includes wired media 
20 such as a wired network or direct-wired connection, and wireless media such as acoustic, RF, 
infrared and other wireless media. Combinations of the any of the above should also be 
included within the scope of computer-readable media. 
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The system memory 130 includes computer storage media in the form of volatile and/or 
nonvolatile memory such as read only memory (ROM) 131 and random access memory 
(RAM) 132. A basic input/output system 133 (BIOS), containing the basic routines that help 
to transfer information between elements within computer 1 10, such as during start-up, is 
5 typically stored in ROM 131. RAM 132 typically contains data and/or program modules that 
are immediately accessible to and/or presently being operated on by processing unit 120. By 
way of example, and not limitation, FIG. 1 illustrates operating system 134, application 
programs 135, other program modules 136 and program data 137. 

The computer 110 may also include other removable/non-removable, 

o 

q 10 volatile/nonvolatile computer storage media. By way of example only, FIG, 1 illustrates a hard 

W 

I s * disk drive 141 that reads from or writes to non-removable, nonvolatile magnetic media, a 

in 

W magnetic disk drive 151 that reads from or writes to a removable, nonvolatile magnetic disk 

y 

J . 152, and an optical disk drive 155 that reads from or writes to a removable, nonvolatile optical 

□ 

m disk 156 such as a CD ROM or other optical media. Other removable/non-removable, 

fU 

|3 15 volatile/nonvolatile computer storage media that can be used in the exemplary operating 
environment include, but are not limited to, magnetic tape cassettes, flash memory cards, 
digital versatile disks, digital video tape, solid state RAM, solid state ROM, and the like. The 
hard disk drive 141 is typically connected to the system bus 121 through a non-removable 
memory interface such as interface 140, and magnetic disk drive 151 and optical disk drive 155 
20 are typically connected to the system bus 121 by a removable memory interface, such as 
interface 150. 
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The drives and their associated computer storage media, discussed above and 
illustrated in FIG. 1, provide storage of computer-readable instructions, data structures, 
program modules and other data for the computer 110. In FIG. 1, for example, hard disk drive 
141 is illustrated as storing operating system 144, application programs 145, other program 
modules 146 and program data 147. Note that these components can either be the same as or 
different from operating system 134, application programs 135, other program modules 136, 
and program data 137. Operating system 144, application programs 145, other program 
modules 146, and program data 147 are given different numbers herein to illustrate that, at a 
minimum, they are different copies. A user may enter commands and information into the 
q 10 computer 20 through input devices such as a tablet, or electronic digitizer, 164, a microphone 
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163, a keyboard 162 and pointing device 161, commonly referred to as mouse, trackball or 
touch pad. Other input devices not shown in FIG. 1 may include a joystick, game pad, satellite 
dish, scanner, or the like. These and other input devices are often connected to the processing 
unit 120 through a user input interface 160 that is coupled to the system bus, but may be 
connected by other interface and bus structures, such as a parallel port, game port or a 
universal serial bus (USB). A monitor 191 or other type of display device is also connected to 
the system bus 121 via an interface, such as a video interface 190. The monitor 191 may also 
be integrated with a touch-screen panel or the like. Note that the monitor and/or touch screen 
panel can be physically coupled to a housing in which the computing device 1 10 is 
incorporated, such as in a tablet-type personal computer. In addition, computers such as the 
computing device 1 10 may also include other peripheral output devices such as speakers 195 
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and printer 196, which may be connected through an output peripheral interface 194 or the 
like. 

The computer 1 10 may operate in a networked environment using logical connections 
to one or more remote computers, such as a remote computer 180. The remote computer 180 
5 may be a personal computer, a server, a router, a network PC, a peer device or other common 
network node, and typically includes many or all of the elements described above relative to 
the computer 1 10, although only a memory storage device 181 has been illustrated in FIG. 1. 
The logical connections depicted in FIG. 1 include a local area network (LAN) 171 and a wide 

8 area network (WAN) 173, but may also include other networks. Such networking 

H 

O 

P 10 environments are commonplace in offices, enterprise-wide computer networks, intranets and 

ru 

I* the Internet. For example, in the present invention, the computer system 1 10 may comprise 

Iff 

^ source machine from which data is being migrated, and the remote computer 180 may 

ly 

] comprise the destination machine. Note however that source and destination machines need 

oik© 

O 

jy not be connected by a network or any other means, but instead, data may be migrated via any 

ru 

p 15 media capable of being written by the source platform and read by the destination platform or 
platforms. 

When used in a LAN networking environment, the computer 1 10 is connected to the 
LAN 171 through a network interface or adapter 170. When used in a WAN networking 
environment, the computer 110 typically includes a modem 172 or other means for establishing 
20 communications over the WAN 173, such as the Internet. The modem 172, which may be 

internal or external, may be connected to the system bus 121 via the user input interface 160 or 
other appropriate mechanism. In a networked environment, program modules depicted 
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relative to the computer 1 10, or portions thereof, may be stored in the remote memory storage 
device. By way of example, and not limitation, FIG. 1 illustrates remote application programs 
185 as residing on memory device 181. It will be appreciated that the network connections 
shown are exemplary and other means of establishing a communications link between the 
5 computers may be used. 



|x The present invention generally operates in an architecture / platform that connects 

b 

tj 10 network-based (e.g., Internet-based) applications, devices and services, and transforms them 

III 

M into a user's personal network which works on the user's behalf, and with permissions granted 

m 

by the user. To this end, the present invention is generally directed to schema-based services 

s 

y ? that maintain user, group, corporate or other entity data in a commonly accessible virtual 

5 

ffj location, such as the Internet. The present invention is intended to scale to millions of users, 

ru 

O 15 and be stored reliably, and thus it is likely that a user's data will be distributed among and/or 
replicated to numerous storage devices, such as controlled via a server federation. As such, 
while the present invention will be generally described with respect to an identity-centric model 
that enables a user with an appropriate identity and credentials to access data by 
communicating with various core or other services, it is understood that the schema-based 
20 services described herein are arranged for handling the data of millions of users, sorted on a 
per-user-identity basis. Note that while "user" is generally employed herein for simplicity, as 
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used herein the term "user" is really a substitute for any identity, which may be a user, a group, 
another entity, an event, a project, and so on. 

As generally represented in FIG. 2, a data access model 200 includes a generic 
navigation module 202 through which applications 204 and the like may access a wide variety 
5 of identity-based data, such as maintained in an addressable store 206. To access the data, a 
common set of command methods may be used to perform operations on various data 
structures that are constructed from the data in the addressable store 206, even though each of 
those data structures may represent different data and be organized quite differently. Such 
ti command methods may describe generic operations that may be desired on a wide variety of 

b 

p 10 data structures, and include, for example, insert, delete, replace, update, query or changequery 

IU 

M methods. 



In accordance with one aspect of the present invention and as described in detail below, 



the data is accessed according to various schemas, with the schemas corresponding to identity- 

b 

fij based services through which users access their data. As used herein, a "schema" generally 

ru 

p 15 comprises a set of rules that define how a data structure may be organized, e.g., what elements 

U 

are supported, in what order they appear, how many times they appear, and so on. In addition, 
a schema may define, via color-coding or other identification mechanisms, what portions of an 
XML document (that corresponds to the data structure) may be operated on. Examples of 
such XML-based documents are described below. The schema may also define how the 
20 structure of the XML document may be extended to include elements not expressly mentioned 
in the schema. 
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As will be understood below, the schemas vary depending on the type of data they are 
intended to organize, e.g., an email-inbox-related schema organizes data differently from a 
schema that organizes a user's favorite websites. Further, the services that employ schemas 
may vary. As such, the generic navigation module 202 has associated therewith a navigation 
5 assistance module 208 that includes or is otherwise associated with one or more schemas 210. 
As will be understood, a navigation assistance module 208 as represented in FIG. 2 
corresponds to one or more services, and possesses the information that defines how to 
navigate through the various data structures, and may also indicate which command methods 
may be executed on what portions of the data structure. Although in FIG. 2 only one 

H 

10 navigation assistance module 208 is shown coupled to the generic navigation module 202, 

m 

M= there may be multiple navigation assistance modules that may each specialize as desired. For 

In 

CP example, each navigation assistance module may correspond to one service. Moreover, 

If 

o 
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although the navigation assistance module 208 is illustrated as a separate module, some or all 
of the operations of the navigation assistance module 208 may be incorporated into the generic 



ru 

p 15 navigation module 202, and vice versa. In one embodiment, the various data structures 



constructed from the schema and addressable store data may comprise XML documents of 
various XML classes. In that case, the navigation assistance module 208 may contain a 
schema associated with each of the classes of XML documents. 

The present invention provides a number of schema-based services that facilitate data 
20 access based on the identity of a user. Preferably, the user need not obtain a separate identity 
for each service, but rather obtains a single identity via a single set of credentials, such as with 
the Microsoft® Passport online service. With such an identity, a user can access data via these 
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services from virtually any network connectable device capable of running an application that 
can call the methods of a service. 

iOGES^m SiJHEMAS 

".NET My Services" comprises identity-centric services which may be generally 
implemented in XML (extensible Markup Language) Message Interfaces (XMIs). While the 
present invention will be described with respect to XML and XMI, it can readily be 
appreciated that the present invention is not limited to any particular language or set of 
interfaces. The .NET My Services model essentially corresponds to one implementation of the 
generic data access model 200 of FIG. 2. 

As generally represented in FIG. 3, .NET My Services 300 is implemented as a set of 
Web services 301-316, each bound to a .NET Identity (PUID, such as a Passport® unique 
identifier similar to a globally unique indentifier when Passport® is the authentication service). 
The services 301-316 can communicate with one another via a service-to-service 
communications protocol (SSCP), described below. As also described below, each service 
presents itself as a set of XML documents that can be manipulated from an application 
program 202 (FIG. 2) or the like using a set of standard methods and domain-specific 
methods. To this end, a user device 320 (endpoint) running such application programs 
connects a user's applications to the services, and the data controlled by those services, such as 
over the Internet or an Intranet, such as over the Internet or an Intranet. Note that endpoint s 
can be client devices, applications or services. In keeping with the present invention, virtually 
any device capable of executing software and connecting to a network in any means may thus 
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give a user access to data that the user is allowed to access, such as the user's own data, or 
data that a friend or colleague has specified as being accessible to that particular user. 

In general, a .NET Identity is an identifier assigned to an individual, a group of 
individuals, or some form of organization or project. Using this identifier, services bound to 
5 that identity can be located and manipulated. A general effect is that each identity (e.g., of a 
user, group or organization) has tied to it a set of services that are partitioned along schema 
boundaries and across different identities. As will be understood, the XML-document-centric 
architecture of .NET My Services provides a model for manipulating and communicating 
service state that is very different from prior data access models. The XML-document-centric 

H 

j| 10 approach, in conjunction with loose binding to the data exposed by the services, enables new 

ru 

H classes of application programs. As will also be understood, the .NET My Services model 300 

I 

Cft presents the various services 301-316 using a uniform and consistent service and method 

W 

model, a uniform and consistent data access and manipulation model, and a uniform and 



HI 



consistent security authorization model. 



p 15 In a preferred implementation, the .NET My Services model 300 is based upon open 

Internet standards. Services are accessed by means of SOAP (Simple Object Access Protocol) 
messages containing an XML payload. Service input and output is expressed as XML 
document outlines, and each of these document outlines conform to an XML schema 
document. The content is available to a user interacting with the .NET My Services service 
20 endpoint 320. 

Turning to FIG. 4, in the .NET My Services model, an application 400 requests 
performance of a method that operates on data structures. The application may make a 
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request that is generic with respect to the type of data structure being operated upon and 
without requiring dedicated executable code for manipulating data structures of any particular 
data type. To this end, the application first contacts a special myServices service 314 to obtain 
the information needed to communicate with a particular service 404, through a set of methods 
5 406 of that service 404. For example, the needed information received from the myServices 
service 3 14 includes a URI of that service 404. Note that the service 404 may correspond to 
essentially any of the services represented in FIG. 3, such as the mylnbox service 309. 

The service 404 includes or is otherwise associated with a set of methods 406 including 
y standard methods 408, such as to handle requests directed to insert, delete, replace, update, 

b 

P 10 query or changequery operations on the data. The set of methods of a particular service may 

!U 

I* also include service specific methods 410. In general, the only way in which an application can 

ffl 

IT - communicate with a service are via that service's methods. 

w 

jj^ Each service includes service logic 412 for handling requests and providing suitable 

O 

f y responses. To this end, the service logic performs various functions such as authorization, 

ru 

13 15 authentication, and signature validation, and further limits valid users to only the data which 

they are permitted to access. The security aspect of a service is not discussed herein, except to 
note that in general, for otherwise valid users, the user's identity determines whether a user can 
access data in a requested manner. To this end, a roleMap 414 comprising service-wide 
roleList document templates 415 and scopes (e.g., part of the overall service's schema 416), in 
20 conjunction with user-based data maintained in an addressable store 418, determines whether a 
particular requested method is allowed, e.g., by forming an identity-based roleList document 
420. If a method is allowed, the scope information in the roleMap 414 determines a shape of 
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data to return, e.g., how much content is allowed to be accessed for this particular user for this 
particular request. The content is obtained in accordance with a content document 422 in the 
service's schema 416 and the actual user data corresponding to that content document in the 
addressable store 418. In this manner, a per-identity shaped content document 424 is 
5 essentially constructed for returning to the user, or for updating the addressable store, as 
appropriate for the method. Note that FIG. 4 includes a number of ID-based roleList 
documents and ID-based content documents, to emphasize that the service 406 is arranged to 
serve multiple users. Also, in FIG. 4, a system document 426 is present as part of the schema 

^ 416, as described below. 

p 

p 10 Returning to FIG. 3, in one implementation, access to .NET My Services 300 is 

fU 

N? accomplished using SOAP messages formatted with .NET My Services-specific header and 

If! 

body content. Each of the .NET My Services will accept these messages by means of an 

^ HTTP POST operation, and generate a response by "piggy-backing" on the HTTP Response, 

p 

iy or by issuing an HTTP POST to a .NET My Services response-processing endpoint 320. In 

fU 

13 15 addition to HTTP as the message transfer protocol, .NET My Services will support raw SOAP 
over TCP, a transfer protocol known as Direct Internet Message Encapsulation (or DIME). 
Other protocols for transferring messages are feasible. 

Because .NET My Services are accessed by protocol, no particular client-side binding 
code, object models, API layers, or equivalents are required, and are thus optional. The .NET 
20 My Services will support Web Services Description Language (WSDL). It is not mandatory 
that applications wishing to interact with .NET My Services make use of any particular 
bindings, and such bindings are not described herein. Instead, the present invention will be 
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generally described in terms of messages that flow between requestors of a particular service 
and the service endpoints. In order to interact with .NET My Services, a service needs to 
format a .NET My Services message and deliver that message to a .NET My Services 
endpoint. In order to format a message, a client needs to manipulate XML document outlines, 
5 and typically perform some simple, known (public-domain) cryptographic operations on 
portions of the message. 

In accordance with one aspect of the present invention, and as described in FIG. 4 and 
below, in one preferred implementation, services (including the mylnbox service 309) present 
three logical XML documents, a content document 422, roleList document 415 (of the 
10 roleMap 414), and a system document 426. These documents are addressable using .NET My 
U. Services message headers, and are manipulated using standard .NET My Services methods. In 

In 

ifS addition to these common methods, each service may include additional domain-specific 

Id 

methods, such as updateContactData. 

Each .NET MyServices service thus logically includes a content document 422, which 



ru 
ru 

p 15 in general is the main, service- specific document. The schema for this document 422 is a 

function of the class of service, as will become apparent from the description of the mylnbox 
service's content document below. For example, in the case of the mylnbox service 309, the 
content document presents data in the shape dictated by the .NET My Services .mylnbox 
schema, whereas in the case of the ".NET FavoriteWeb Sites" service 308, the content 
20 document presents data in the shape dictated by a .NET myFavoriteWebSites schema. 

Each service also includes a roleList document 415 that contains roleList information, 
comprising information that governs access to the data and methods exported by the service 



- 17- 



404. The roleList document is manipulated using the .NET My Services standard data 
manipulation mechanisms. The shape of this document is governed by the .NET My Services 
core schema's roleListType XML data type. 

Each service also includes a system document 426, which contains service-specific 
system data such as the roleMap, schemaMap, messageMap, version information, and service 
specific global data. The document is manipulated using the standard .NET data manipulation 
mechanism, although modifications are limited in a way that allows only the service itself to 
modify the document. The shape of this system document 426 may be governed by the system 
document schema for the particular service, in that each service may extend a base system 
document type with service specific information. 

As is understood, the present invention is generally based on schemas, which in general 
comprise a set of rules or standards that define how a particular type of data can be structured. 
Via the schemas, the meaning of data, rather than just the data itself, may be communicated 
between computer systems. For example, a computer device may recognize that a data 
structure that follows a particular address schema represents an address, enabling the computer 
to "understand" the component part of an address. The computer device may then perform 
intelligent actions based on the understanding that the data structure represents an address. 
Such actions may include, for example, the presentation of an action menu to the user that 
represents things to do with addresses. Schemas may be stored locally on a device and/or 
globally in a federation's "mega-store." A device can keep a locally-stored schema updated by 
subscribing to an event notification service (in this case, a schema update service) that 
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automatically passes messages to the device when the schema is updated. Access to globally 
stored schemas is controlled by the security infrastructure. 

>-GENERAfrS €IIEA>fA COM^QNALm 

The .NET My Services data is defined using annotated XSD (extensible or XML 
Structure Definitions) schema files. The XSD files accurately type the data, but since XSD is a 
verbose and complex language, it is not a particularly efficient way to convey structure and 
meaning. Thus, for purposes of simplicity herein, the mylnbox schemas are described below in 
terms of schema outlines with accompanying element/attribute descriptions. These document 
outlines accurately show the structure of the data contained within a service. However, 
because the present application is not viewable in color, the nodes, elements and/or attributes 
of the schema outlines (which may be described as bold blue, or blue), are represented in the 
schema outlines as boldface type. Those described as underlined red, or red, are represented 
as underlined type, while others referred to as black are represented in normal type. 

The meaning of these bold (blue), underlined (red) and normal (black) items has 
significance with respect to the data model and to the data language that accesses and 
manipulates the data (e.g., via the insert, delete, replace, update, query, changequery or other 
methods). For example, each document described below contains a root element having an 
element name that matches that of the service, e.g., the mylnbox service has a root element 
named mylnbox. The .NET My Services name for this item is the root. 

Documents contain elements that resemble first-class top-level objects, including, for 
example, <catDef7> , < myApplicationsSettings /> (other another name as appropriate) and 
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<order/> Such items are denoted in the outlines as bold (blue), and may be identified using an 
<xdb:b!ue/> tag. Bold (blue) items define major blocks of data within a service. These node 
sets are directly addressable by an identifier attribute, and their change status is tracked 
through a changeNumber attribute. Top-level bold blue items may be considered objects. As 
5 seen below, some bold (blue) objects contain nested bold blue objects. They usually contain 
frequently changing underlined (red) properties, which reduces the amount of synchronization 
traffic. Nested bold (blue) items may be considered property groups. 

Each bold blue item contains one or more underlined (red) items which are elements or 

attributes. These items may be identified using the < xdb:red /> tag. These items are special in 

O 

£3 10 that they may be used within predicates (filters) to aid in xdb:bold blue selection. These items 

ru 

f 4 are also directly addressable and may be manipulated directly by the data manipulation 

in 

ffl language. 

W 

J . Each colored red element may contain one or more non-colorized elements and 

Q 

jy attributes, which are valid and semantically meaningful XML items in the service document. 



u 



ru 



p 15 Such items are opaque to the data language. These uncolored (i.e., non-bold or underlined) 
elements and attributes may not be addressed directly, may not be selected in a node selection 
operation, and may not be used in a predicate node test. Note that if one of these items is in 
the path to an underlined red item, it may be used in a location step to the underlined red item, 
but may not be used as the selected node. Note that being opaque does not mean that the item 
20 is not considered during schema validation, but rather means that the item may not be used in a 
predicate, may not be directly addressed, and may not be inserted by itself. As can be readily 
appreciated, in this manner, the .NET My Services thus limits the granularity of access to 
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nodes within the service document, since only xdb:bold blue and xdb: underlined red marked 
items are directly addressable, and only those elements and attributes tagged with the 
xdb:underlined red annotation may be used in predicates to influence node selection. Using 
this technique, the .NET My Services storage system can efficiently manage indexes, increase 
the performance of node selection, partially shred the document data, and in general (because 
the node selections are well defined) fine-tune the node selection logic on a per-xdb:blue basis. 
The primary purpose of the xdb:blue is to define a base-level XML object that is designed to 
be operated on as a unit. The primary purpose of the xdb:red items is to aid in the selection of 
xdb:bold blues. The xdb:red items may be changed by the data language primitives so some 



P 10 level of fine-grained manipulation of the data is available, but only in very limited ways. 

ry 

fa Bold blue items have unique IDs, which are usually assigned by .NET My Services, and 



M 

01 are returned from update operations within the new blueld node. In all cases, the order of 

[ xxxBold blue follows the pre-order traversal of the document XML tree. Item IDs are UUIDs 

n 

jy in the following format (h stands for a hexadecimal digit): hhhhhhhh-hhhh-hhhh-hhhh- 

iU 

q 15 hhhhhhhhhhhh. 

In addition to identifiers, names and change numbers, nodes and especially red nodes 
may include creator identifiers, category information, and {any} fields. Category information 
enables data to be grouped and/or distinguished in some way, such as to share certain calendar 
information with golf buddies, send an email to immediately family, designate things such as 
20 which telephone number is the user's primary number, e.g., if a user has a second home, and so 
on. Fields of type "any" may comprise fully-typed, namespace-qualified fields that contain any 
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type of content (e.g., free-form XML) therein. Such "any" fields thus allow extensibility of the 

schema, yet maintain the defined structure of a schema. 

In one implementation, the core data-manipulation language implemented by the .NET 

My Services includes an insertRequest, or insert message. This primitive inserts any schema- 
5 valid XML fragment into a selected context, thereby changing the existing state of the 

document. A queryRequest, or message, retrieves data, such as to retrieve a document. 

Multiple queries may be specified in one request, and queries that select nothing are considered 

successful. It is possible to assert that the number of nodes in the selection falls in a given 
fi range. This is expressed using minOccurs and maxOccurs attributes. If a 

q 10 minOccurs/maxOccurs test fails on any node, the request is considered unsuccessful. Note that 

m 

|* this is different from a failure code, which would be returned, for example, for a malformed 

in 

If! request. 

|y 

j; ; A deleteRequest primitive deletes the selected nodes and all their children. Note that, 

b 

qj just like for other requests, attributes may be selected as well as elements. Empty selections 

iU 

13 15 result in successful operations, similar to Query. The minOccurs/maxOccurs tests are 
supported wherever select is allowed. 

A replaceRequest primitive (replace message) is designed to replace the content of each 
of the selected nodes with the specified new content. Selected nodes themselves are not 
affected in any way. This may be considered as an atomic delete of the content of the selected 
20 node, followed by an insert. The content (text, attributes, elements) in the selected nodes are 
replaced with the new item specified in this message. The node type of the selected node and 
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of the replacement node are thus required to be the same. The changequery request essentially 
returns result comrpising data that has changed. 

As mentioned above, each of the services includes a RoleList document and scope 
information that describes which users have what type of access to which data. For example, a 
data owner will have read/write access to his or her own data, and can provide various types of 
rights to that data to other users based on their IDs, (e.g., read only to some users, read write 
to others). Each role list identifier may be associated with a scope, by which the kinds of data 
stored according to a given schema can be controlled per user. For example, a user can give a 
friend (with one identity) access via a service to a home telephone number, home address and 
so forth, but can give other users (with other identities) access only to a business telephone 
number. In general, a scope can be defined such that that it includes everything except any 
specifically listed items, or excludes everything except any specifically listed items. 

j nylnbox - 

The.NET Inbox service, generally referred to as mylnbox, is designed to store and 
manage e-mail related information for the associated identity. A primary purpose of the 
mylnbox service is to supply this information, on demand, to applications operating on the 
identity's behalf. Using this service, an identity can manage e-mail from a variety of devices, 
and even manage multiple accounts from the same application. It is expected that this service 
will support some form of subscription, or pending query, so that applications or services can 
reliably cache information contained within the service. An example of this caching might be 
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an e-mail application or service. For each folder and message in the store, a subscription is 
issued against this service for that item. If the item changes, the application can refresh itself. 

This mylnbox service uses an XML schema to describe email, a user's email store, and 
the methods by which email is sent and received from the store. Throughout the following 
5 examples, an "hs" as in <hs: scope . . > represents the namespace or schematic that may be 
used to interpret the corresponding element. 




Q 
Q 

m 
in 

01 

w 



The mylnbox service controls access by using the rtO, rt2 and rt99 roleTemplates, using 



10 the following scopes: 



scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 



<hs: shape base=t> 



15 



</hs:shape> 
</hs:scope> 



0 

ru 
ru 

Q 



20 



scope onlySelfEIements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 



<hs: shape base=nil> 



<hs:include select=//*[@creator='$callerId']/> 



</hs:shape> 
</hs:scope> 



25 



scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 



<hs: shape base=nil> 



<hs:include select=//subscription[@creator='$callerId']/> 



</hs:shape> 
</hs:scope> 



30 



scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8f> 
<hs: shape base=nil> 

<hs: include select=//* [cat/@ref=' hs : public' ]/> 
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<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

The mylnbox roleTemplate rtO role gives complete read/write access to the information 
within the content document of the service being protected through this roleTemplate. The 
following table illustrates the available methods and the scope in effect when accessing the 
mylnbox service through that method while mapped to this roleTemplate: 

TABLE - mylnbox roleTemplate rtO 
jmethod ijscojpe/nameij 
IQuery ijallElements f 
ijlnsert ijallElements | 

ijReplace ijallElements | 
ijDelete IjallElements | 
IjUpdate IjallElements jj 
IjsendMessage ijallElements jj 
IsaveMessage ijallElements jj 
jicopyMessage ijallElements jj 



The mylnbox roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create and 
manipulate their own subscription nodes. The following table illustrates the available methods 
and the scope in effect when accessing the mylnbox service through that method while mapped 
to this roleTemplate: 
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TABLE - 


mylnbox roleTempIate rt2 


method 


[scope/name 


ilQuery ijallElements 


ijlnsert 


fonlySelfSubscriptionElements 1 


Replace 


jonlySelfSubscriptionElements 1 



iDelete jonlySelfSubscriptionElements j 
ilsendMessage i|allElements 
ijsaveMessage |allElements 



The mylnbox roleTempIate rt99 blocks access to the content document. Note that lack 

5 of a role in the roleList has the same effect as assigning someone to rt99. 

Q 

13 ii <^ >mvft ibox / Content 1 

I* The content document is an identity centric document, with its content and meaning a 

%n 

j function of the user identifier (puid) used to address the service. Accessing the document is 

IS 

| s4s 10 controlled by the associated roleList document. The following table comprises a schema 

b 

ffj outline that illustrates the layout and meaning of the information found in the content 

ry 

p document for the mylnbox service: 



m:myInbox changeNumber =". . instanceld="..." 

xmlns:m="http://schemas.microsoft.com/hs/200 1/1 0/mylnbox" 
xmlns:hs= <c http://schemas.microsoft.com/las/200 1/1 0/core">i..i 
<m:account changeNumber =" . " id=" creator - '...">i unbounded 
<m:name xml:lang=" dir="...">i..i</m:name> 
< m:email >i i< /m:email > 
< m:primarv > 1 1 </ m:primarv > 
< m:cat ref- '...">o lln hniind«i</ m;cat > 
<m:pop3Settings>o.i 

<m : server> XA </m : server> 
<m:userName>i..i</m:userNanie> 
<m:password>i..i</m:pass\vord> 
</m:pop3Settings> 
(any} 
</m:account> 
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<m:folder changeNumber - id=". creator -'. .."> 4 unbounded 
< m:name xml:lang=" .." dir="...">i i< /m:name> 
< m:type> i i < /m:type > 
<m:unread >n i < /m:unread > 
<m:parentFolder ref=" . . . "> 0 . . 1 </m : parentFolder> 
< m:childFolderCount >o i < /m:childFolderCount > 
fanvf 

</m:foIder> 

<m:message changeNumber -'..." id- c ..." creator="... '^..unbounded 
<m:messageStatus changeNumber ="...">i i 
< m:isRead > i . . i </ m:isRead > 
<m:folder ref="...">,.. 1 </m:folder> 
<m:flag>o..i 

< m:state >i i< /m:state> 

<m:title xml:lang=".. " dir=" ..">i .,</m:title> 

<m:reminderDate> 0 ..i</m:reminderDate> 

{<*")>} 
</m:flag> 

< m:state >i i < /m:state > 
{any} 
</m : mess ageS t at us> 

<m:messageContent changeNumber =" ..">i i 
< m:cat ref- '...">n „nhn.,nH ft H</ m:cat > 
<m:account ref- '. .."> 0 ..i</m:account> 
<m:messageType>i .1 

<m:type >i i< /m:type > 

<m:contentType>o. i </m : contentType> 

</m:messageType> 
< m:size > i . . i </ m:size > 
< m:importance > u </ m:importance > 
<m:sensitivity>i..i</m:sensitivity> 
< m:hasAttachments > u </ m:hasAttachments > 
<m:isJunkMail>i..i < /m:isJuiikMail> 
<m:containsAdultContent>]..i</m:containsAdultContent> 
< m:conversationId >o i < /m:conversationId > 
<m:conversationlndex>o..i</m:conversationlndex> 
<m : d ateRecei ved >i \ </m : d ateRecei ved > 
< m:dateSent >i i</ m:dateSent > 
<m:subject xml:lang='\. " dir="...">i..i 

<m:prefix> i i </m:prefix> 

< m:text >i i</ m:text > 
</m:subject> 
<m:from>i i 

< m:name xml:lang="..." dir="...">i i< /m:name > 
< m:email> i . i </ m:email > 
</m:from> 
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<m:recipient type="... '^..unbounded 

<m:name xml:iang=". .." din="...">i..i</m:name> 

<m:email>i..i</m:email> 
</m:recipient> 

<m:plainBody>o..i</m:plainBody> 
<m:htmlBody>o.i 

<m:body>i .i</m:body> 
<m: inlineAttachment> 0 unbounded 
<m:uri>i..i</m:uri> 
<m:contentType> i .. i </m :contentType> 
<m:content>i .i</m:content> 
</m:inlineAttachment> 
</m:htmlBody> 

<m:attachment>o..unbounded 

<m:name>i..i</m:name> 

<m:ord> i . i </m : ord> 

<m:contentType>i . i </m : contentType> 

<m: content>i .. i </m:content> 
</m:attachment> 

<m:messagePart id=" . . ">o..unbounded 

<m:parentPart ref="...">i i</m:parentPart> 
<m: order>i .. i </m:order> 
<m: contentType>i i</m: contentType> 
<m:size>i. i</m:size> 

<m:contentDisposition> 0 .i</m:contentDisposition> 
<m:contentld>o..i</m:contentld> 
<m:contentLocation> 0 .i</m:contentLocation> 
<m:contentTransferEncoding> 0 . i </m:contentTransferEncoding> 
<m : partContent> 0 .. i </m : part Content> 
</m:messagePart> 

<m:preview xml:lang=" .." dir= <c ..."> 0 ..i < /ni:preview> 
<m:single2822Header> 0 ..unbounded < /ni:single2822Header> 
<m:raw2822Content>o.i</m:raw2822Content> 
<m:raw2822Headers> 0 ..i</m:raw2822Headers> 

</m:messageContent> 
</m:message> 

<m:draft changeNumber =" . . " id- \." creator-'... ''^unbounded 
<m:draftStatus changeNumber -', ..">i i 
< m:isRead >i i< /m:isRead > 
<m:folder ref="...">,.. 1 </m:folder> 
<m:flag>o..i 

<m:state >i i< /m:state> 

<m:title xml:lang=" .." dir="..."> 1 .. 1 </m:title> 

<m: reminderDate> 0 . i </m : reminderDate> 

{any} 
</m:flag> 

<m:state>i i</m:state> 
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{any} 
</m:draftStatus> 

<m:draftContent changeNumber ="...">i i 
< m:cat ref=" ..">n »nhnnnriPd< /m:cat > 
<m : account ref=" ; . "> t \ </m : account> 
<m:draftType>i..i 

< m:type >i i< /m:type > 

<m : contentType >n i < /m : conten tType > 

</m:draftType> 
< m:size >i i < /m:size > 
<m:importance >i i< /m:importance > 
< m:sensitivitv >i i< /m:sensitivitv > 
< m:hasAttachments >i i</ m:hasAttachments > 
<m:conversationId >n i < /m:conversationId > 
< m:conversationIndex >n 1 < /m:conversationIndex > 
< m:subiect xml:lang=" dir=" ..">i..i 

<m:prefix>i..i</m:prefix> 

< m:text >i . </ m:text > 
< /m:subiect > 
<m:from>i i 

< m:name xml:lang="..." dir="...">i i< /m:name > 
< m:email >i i < /m:email > 
</m:from> 

< m: recipient type- 6 ..."> 0 ..unbounded 

<m:name xml:lang=" . " dir="...">i..i</m:name> 

< m:email >i i< /m:email > 
< /m:recipient > 

< m:plainBodv >n i </ m:plainBodv > 
< m:htmlBodv >n i 

<m:body>i..i</m:body> 

< m: inline Attachment unbounded 
< m:uri >i i< /m:uri > 
< m:contentType > u </ m: conten tType > 
<m:content > u < /m:content > 

< /m:inlineAttachment > 
< /m:htmlBodv > 
< m:attachment >n unhnundftd 

< m:name > hA < /m:name > 

< m:ord >i i < /m:ord > 

< m:contentType >i T < /m : contentType > 

< m:content >i i < /m:content > 
< /m: attachment 

<m:draftPart changeNumber =" ,.">i unbounded 
<m:parentPart ref=" . ..">u </m:parentPart> 
< m:order > u </ m:order > 

<m : contentType> i i </m : con tentType> 
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<m:size> i i< /m:size > 

<m:contentDisposition >n \ < /m:contentDisposition > 
<m:content!d >n i< /m:contentId > 
<m:contentLocation >n t < /m : contentLocation > 
<in:contentTransferEncoding >o i< /m:contentTransferEncoding > 
< m:partContent >i i< /m:partContent > 

</m:draftPart> 

<m:preview xml:lang=" . " dir=" .."> 0 ..i</m:preview> 
<m:single2822Header>o. iU nbounded < /m:single2822Header> 
<m:raw2822Content>o..i</m:ravv2822Content> 
<m:raw2822Headers>o.i</m:raw2822Headers> 
{any} 
</m:draftContent> 

</m:draft> 

<m:rule sequence - changeNumber =" . id=" .." creator-". .."><> ..unbounded 
<m:nanie xml:lang="..." dir="...">i..i</m:nanie> 
< m:state >i i< /m:state > 
< m:runat >i i< /m:runat > 
< m:runwhen >i i< /m:runwhen > 
< m:tvpe >i i< /m:tvpe > 

< m:provider xml:lang="..." dir=" ..">i i< /m:provider > 
<m : condition select=" . . . "> 1 . . 1 </m : condit ion> 
<m:action sequence-'. . . ">i ..unbounded 
<m:copyMessage> 0 . i 

<m:targetFolder select=" . .">i..i </m:targetFolder> 
</m:copyMessage> 
<m:moveMessage>o. i 

<m:targetFolder select=" ..'>i..i</m:targetFolder> 
</m:moveMessage> 

<m:deleteMessage>o..i</m:deleteMessage> 
<m:assignCategory> 0 . i 

< m:cat re[=" . "> 0 ..unbounded < /nncat > 
</m:assignCategory> 
<m:forwardMessage>o i 

<m:recipient type="...' , > 0 unbounded 

<m:name xml:lang=". .." dir=" ..">i..i</m:name> 
<m:email>i..i</m:email> 
</m:recipient> 
</m:forwardMessage> 
<m:forwardAsAttachment> 0 . i 
<m:recipient type=" ">o..unbounded 

<m:name xml:lang=" dir=' c ...">i..i</m:name> 
<m:email>i .i</m:email> 
</m:recipient> 
</m:forwardAsAttachment> 
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<m:serverReply> 0 ..i 

<m:subject xml:lang=" . " dir="...">i.., 

<m:prefix>i .i</m:prefix> 

<m : text> i . . i </m : text> 
</m:subject> 

<m:simpleBody xml:lang=" dir="...">i. 1 </m:simpleBody> 
</m:serverReply> 
<m:redirectMessage> 0 ..i 

<m:recipient type-'. . "> 0 ..unbounded 

<m:name xml:lang=" .." dir=" ..">i..i</m:name> 
<m:email>i . i </m:email> 
</m:recipient> 
</m:redirectMessage> 
<m:flagMessage>o..i 
<m:flag>i..i 

<m:state>i.i</m:state> 
<m:title xml:lang='\. " dir=" ..">,. j</m:title> 
<m:reminderDate>o..i</m:reminderDate> 
{any} 
</m:flag> 
</m:flagMessage> 

<m:markAsRead>o. i </m:markAsRead> 

<m:stopProcessingRulesOfThisType> 0 . i</m:stopProcessingRulesOfThisType> 
</m:action> 
{any} 
</m:rule> 

<m:subscription changeNumber =" . id- 6 ..." creator ="..."> 0 ..unbounded 

<hs:trigger select="..." mode-'..." baseChangeNumber= a ...">i..i</lis:trigger> 

<hs :expiresAt> 0 „i </hs:expiresAt> 

<hs:context uri=" ..">i..i /a/fy/</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscription> 
{any} 

</m;myInbox> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 
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The /mylnbox (minOccurs=l maxOccurs=l) element represents the root element of 
mylnbox. The /myInbox/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a particular service is provisioned for a user. 
The /mylnbox/account (minOccurs=l maxOccurs=unbounded) element represents a 
provisioned user's email account. This element can optionally contain POP3 settings for 
mylnbox services that support POP3 aggregation. 

The/myInbox/account/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/account/@id (minOccurs=l maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services generates and 
assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. After an ID has been assigned, the attribute is read only and attempts to 
write it are silently ignored. 
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The /myInbox/account/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. 

The /mylnbox/account/name (string minOccurs=l maxOccurs=l) field maintains the 
display name of the account. The /myInbox/account/name/@xml:lang (minOccurs=l 
5 maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
country code as described in RFC 1766 (wherein ISO stands for International Organization for 
Standardization and RFC stands for Request For Comment). The value of this attribute 
indicates the language type of the content within this element. The 

/myInbox/account/name/@dir (string minOccurs=0 maxOccurs=l) optional attribute specifies 

1 3 

q 10 the default layout direction for the localized string. Valid values are rtl (right to left) and ltr 

W 

H (left to right). 

m 

01 The /mylnbox/account/email (string minOccurs=l maxOccurs=l) field maintains the 

14 

I SMTP email account. 

1 4? 
V? 

II jj The /mylnbox/account/primary (boolean minOccurs=l maxOccurs=l) element defines 

m 

q 15 this account as a primary or non-primary account. There can be only one primary account, and 

I* 

it can never be deleted. 

The /myInbox/account/cat/@ref (anyURI minOccurs=l maxOccurs=l) attribute 
references a category definition (catDef) element using the rules outlined in the .NET 
Categories section (myCategories) described above. 
20 The /myInbox/account/pop3 Settings (minOccurs=0 maxOccurs=l) defines pop3 

settings, if this account is a POP3 account. Note that the primary account can not be a POP3 
account. The /myInbox/account/pop3 Settings/server (string minOccurs=l maxOccurs=l) field 
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contains the name of the POP3 server . The /myInbox/account/pop3Settings/userName (string 
minOccurs=l maxOccurs=l) contains the username of the POP3 account. The 
/myInbox/account/pop3Settings/password (string minOccurs=l maxOccurs=l) contains the 
password of the POP3 account. 

Like other unbounded elements, multiple accounts may be set up, providing 
significantly functionality. For example, one node may maintain a user's primary email 
account, with another node set up as a secondary account. Even though email is received on 
one account, e.g., a POP3 account, it can be sent out on the other, e.g., an office email 
account. 

The /myInbox/account/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

Folders represent the unit of containment for the mylnbox service. The 
/mylnbox/folder (minOccurs=4 maxOccurs^unbounded) folder element in mylnbox are 
containers for messages, although not directly. Messages are related to folders via the 
/mylnbox/message/messageStatus/folder ref="" attribute. Folders can be organized 
hierarchically, although again not directly. Instead, folder containment is modeled using the 
/mylnbox/folder/parentFolder ref= attribute. If a folder is deleted, all associated messages, 
folders and their messages are deleted. It is recommended that instead of deleting a folder 
directly, it should be moved to the type- 'deleted" folder first. There are four built in types of 
folders, and these can be identified by four special type element values: /folder/type = 'inbox' is 
the Inbox folder, /folder/type = 'sent' is the Sent Items folder, /folder/type = 'drafts' is the 
Drafts folder, /folder/type = 'deleted' is the Deleted Items folder. These four special folders 



-34- 



will always exist in a provisioned .NET Inbox account, and cannot be deleted or modified. To 
create user defined folders, the standard .NET My Services insert method can be used, with the 
type set to 'custom'. Custom (user-defined) folders can be created, deleted or modified, and 
virtual hierarchies can be established via the parent folder attribute. 

The /myInbox/folder/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/folder/@id (minOccurs=l maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services generates and 
assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. After an ID has been assigned, the attribute is read only and attempts to 
write it are silently ignored. 

The /myInbox/folder/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. The /mylnbox/folder/name 
(string minOccurs=l maxOccurs=l) element contains the name of the e-mail folder. For the 
four special folders, this element is read only. For custom folders, this element can be edited. 
The /myInbox/folder/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute is used 
to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 1766. 
The value of this attribute indicates the language type of the content within this element. The 
/myInbox/folder/name/@dir (string minOccurs=0 maxOccurs=l) optional attribute specifies 
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the default layout direction for the localized string. Valid values are rtl (right to left) and ltr 
(left to right). 

The /mylnbox/folder/type (string minOccurs=l maxOccurs=l) element contains a type 
identifier for this folder, and will contain the value 'inbox, 'sent', 'drafts' or 'delete' for the 
four special folders. For other folders, this value will be 'custom'. 

The /mylnbox/folder/unread (unsignedLong minOccurs=0 maxOccurs=l) contains the 
calculated count of the unread messages associated with this folder. This element is read only. 
The /mylnbox/folder/parentFolder (minOccurs=0 maxOccurs=l) element contains a ref 
attribute that specifies the ID of the parent folder. For top-level folders, this attribute = "". 
This attribute cannot be set on the four special folders, as they remain top level folders. 

The /myInbox/folder/parentFolder/@ref (minOccurs=0 maxOccurs=l) contains a 
uuidType used to specify a universally unique identifier (UUID). 

The /mylnbox/folder/childFolderCount (unsignedLong minOccurs=0 maxOccurs=l) 
attribute is calculated by the service, and indicates how many subfolders that folder contains. 
Note that fields can be calculated rather than stored or changed by the user. For example, a 
calculated field is used to maintain information such as how many items are in a folder since 
this number is not something a user directly decides, but rather results from other information. 

The /myInbox/folder/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

The /mylnbox/message (minOccurs=0 maxOccurs=unbounded) element defines a single 
message in mylnbox in the base schema. A message represents an email message, and is 
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divided into two sub-groups 'messageStatus' and 'messageContent'. This field is for received 
and sent messages, (not for drafts). 

The /myInbox/message/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/message/@id (minOccurs=l maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, NET My Services generates and 
assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. After an ID has been assigned, the attribute is read only and attempts to 
write it are silently ignored. 

The /myInbox/message/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. The 

/mylnbox/message/messageStatus (minOccurs=l maxOccurs=l) element defines the status of 
the email, and frequently changes. Caching clients should take advantage of this when 
deciding which part of the message to change. 

The /myInbox/message/messageStatus/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 
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Certain email-related elements frequently change. If a user wants to synchronize on 
each change, a great deal of information would need to be exchanged, even though most 
changes are simple changes in message status, rather than content, such as from unread to 
read. Status information is thus maintained separately. The 

/mylnbox/message/messageStatus/isRead (boolean minOccurs=l maxOccurs=l) element 
defines the read/unread state of the message, and can be modified. The 
/mylnbox/message/messageStatus/folder (minOccurs=l maxOccurs=l) element defines the 
single folder to which this message logically belongs. The 

/myInbox/message/messageStatus/folder/@ref (minOccurs=0 maxOccurs=l) uuidType is used 
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the client-defined text of the flag. The /myInbox/message/messageStatus/flag/title/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
20 /myInbox/message/messageStatus/flag/title/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
to left) and ltr (left to right). 
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The /mylnbox/message/messageStatus/flag/reminderDate (dateTime minOccurs=0 
maxOccurs=l) field maintains the client-defined reminder date of the flag. The 
/myInbox/message/messageStatus/flag/{any} (minOccurs=0 maxOccurs=unbounded) field 
allows for extensibility. 

The/mylnbox/message/messageStatus/state (string minOccurs=l maxOccurs=l) 
element defines the sent/received state of the message. This element is read only, which means 
that it can be queried for, but not updated. The /myInbox/message/messageStatus/{any} 
(minOccurs=0 maxOccurs=unbounded) field allows for extensibility. 

The/mylnbox/message/messageContent (minOccurs=l maxOccurs=l) element defines 
the content of the message. This data changes rarely in a normal application. 

The /myInbox/message/messageContent/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /mylnbox/message/messageContent/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing either a global 
category definition (in either the .NET Categories service system document or an external 
resource containing category definitions), or by referencing an identity-centered category 
definition in the content document of the .NET Categories service for a particular PUID. 

The /myInbox/message/messageContent/cat/@ref (anyURI minOccurs=l 
maxOccurs=l) attribute references a category definition (catDef) element using the rules 
outlined in the .NET Categories section (myCategories) described above. 
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The /mylnbox/message/messageContent/account (minOccurs=0 maxOccurs=l) element 
contains a reference to the /mylnbox/account element to which this message was sent. 

The /myInbox/message/messageContent/account/@ref (minOccurs=0 maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUED). 

The /mylnbox/message/messageContent/messageType (minOccurs=l maxOccurs=l) 
subelements of this element describe the contents of the message. 

The /mylnbox/message/messageContent/messageType/type (string minOccurs=l 
maxOccurs=l) element contains a value that provides the client with enough information to 
render an 'Inbox' view of the messages. Valid values include 'voice 5 , 'subscription', 'fax', 
'dsn', 'readReceipt', 'meetingResponse', 'meetingRequest', 'email' or 'HveEmaiF. 

The /mylnbox/message/messageContent/messageType/contentType (string 
minOccurs=0 maxOccurs=l) field maintains the contentType of the message (in accordance 
with RFC 2045). Examples of this are: 'text/plain' and 'multipart/mime'. 

The /myInbox/message/messageContent/messageType/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibility. 

The /mylnbox/message/messageContent/size (unsignedLong minOccurs=l 
maxOccurs=l) element contains the size, in bytes, of the entire RFC2822 message in the store. 

The /mylnbox/message/messageContent/importance (string minOccurs=l 
maxOccurs=l) element indicates the importance of this message. Valid values include 'low', 
'normal', or 'high'. The default is 'normal'. 
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The /mylnbox/message/messageContent/sensitivity (string minOccurs=l maxOccurs=l) 
element indicates the sensitivity of the message. Valid values include 'normal', 'personal', 
'private', or 'confidential'. 

The /mylnbox/message/messageContent/has Attachments (boolean minOccurs=l 
maxOccurs=l) element indicates whether a message has one or more attachments. The value 
will either be 0 (to indicate that the message has no attachments) or 1 (to indicate that the 
message has one or more attachments). 

The/mylnbox/message/messageContent/isJunkMail (boolean minOccurs=l 
maxOccurs=l) element is read only and is set by the mylnbox service when the message was 
delivered, and indicates if the message was marked as junk mail by the junk mail filter. 

The /mylnbox/message/messageContent/containsAdultContent (boolean minOccurs=l 
maxOccurs=l) read-only element is set by the mylnbox service when the message was 
delivered and indicates if the message was determined to contain adult content by the adult 
content mail filter. 

The /mylnbox/message/messageContent/conversationld (string minOccurs=0 
maxOccurs=l) optional element identifies the 'conversation,' or e-mail thread of which this 
message is a part. 

The /mylnbox/message/messageContent/conversationlndex (string minOccurs=0 
maxOccurs=l) optional element identifies the 'conversation,' or e-mail thread of which this 
message is a part. 
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The /mylnbox/message/messageContent/dateReceived (dateTime minOccurs=l 
maxOccurs=l) read-only element contains the UTC date/time the message was received, and 
appears in all messages except ones that were sent by the user. 

The /mylnbox/message/messageContent/dateSent (dateTime minOccurs=l 
maxOccurs=l) read-only element contains the UTC date/time the message was sent. For 
/message/messageStatus/state-'sent" messages, this element represents the time the message 
was sent. For /message/messageStatus/state- 'received" this element represents the time the 
sender sent the message. 

The/mylnbox/message/messageContent/subject (minOccurs=l maxOccurs=l) element 
contains the subject of the message. This element contains both a prefix and text sub-elements, 
to allow clients to sort on the non-prefix part of the subject (e.g., so RE: RE: doesn't get 
sorted). The /myInbox/message/messageContent/subject/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The /myInbox/message/messageContent/subject/@dir 
(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /mylnbox/message/messageContent/subject/prefix (string minOccurs=l 
maxOccurs=l) contains the prefix of a message subject, (e.g., 'FW:'). 

The /mylnbox/message/messageContent/subject/text (string minOccurs=l 
maxOccurs=l) contains the subject of a message minus the prefix (e.g., 'hello there'). 
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The /mylnbox/message/messageContent/from (minOccurs=l maxOccurs=l) is a read- 
only element that describes who this message is from. 

The /mylnbox/message/messageContent/from/name (string minOccurs=l 
maxOccurs=l) field includes the display name of an e-mail address. The 
5 /myInbox/message/messageContent/from/name/@xml:lang (minOccurs=l maxOccurs=l) 

required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/message/messageContent/from/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
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specified. 

The /myInbox/message/messageContent/recipient/@type (string minOccurs=l 
maxOccurs=l) field specifies whether the recipient is in the 'to 5 or 'cc' list. 

The /mylnbox/message/messageContent/recipient/name (string minOccurs=l 
20 maxOccurs=l) stores the display name of the recipient's e-mail address. The 

/myInbox/message/messageContent/recipient/name/@xml : lang (minOccurs= 1 maxOccurs= 1 ) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
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described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/message/messageContent/recipient/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/message/messageContent/recipient/email (string minOccurs=l 
maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/message/messageContent/plainBody (string minOccurs=0 
maxOccurs=l) field contains the plain body representation of the message. This element is 
returned by passing the 'includeSimpleMessageView' element in query options. 

The /mylnbox/message/messageContent/htmlBody (minOccurs=0 maxOccurs=l) field 
contains the html body representation of the message. This element can also contain inline 
attachments that are related to the html content via the 'uri' element of the inline attachment. 
This element is returned by passing the 'includeSimpleMessageView' element in query options. 
The/mylnbox/message/messageContent/htmlBody/body (string minOccurs=l maxOccurs=l) 
field contains the contents of the body. 

The /mylnbox/message/messageContent/htmlBody/inlineAttachment (minOccurs=0 
maxOccurs=unbounded) element represents an inline attachment The 
/mylnbox/message/messageContent/htmlBody/inlineAttachment/uri (string minOccurs=l 
maxOccurs=l) field contains the client-defined unique identifier for the inline attachment. This 
element is used to identify this attachment location within the html body of a message. 

The /mylnbox/message/messageContent/htmlBody/inlineAttachment/contentType 
(string minOccurs^l maxOccurs=l) field contains the Content-Type of the attachment. 
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The /mylnbox/message/messageContent/htmlBody/inlineAttachment/content 
(base64Binary minOccurs=l maxOccurs=l) field contains the base64 encoded attachment 
content. 

The /mylnbox/message/messageContent/attachment (minOccurs=0 
maxOccurs=unbounded) element represents a mail attachment and is returned by passing the 
'includeSimpleMessageView Attachments' element in query options. 

The /mylnbox/message/messageContent/attachment/name (string minOccurs=l 
maxOccurs=l) field contains the client defined name of the attachment. 

The /mylnbox/message/messageContent/attachment/ord (unsignedLong minOccurs=l 
maxOccurs=l) field contains the unique order that this attachment should appear relative to all 
other attachments. 

The /mylnbox/message/messageContent/attachment/contentType (string minOccurs=l 
maxOccurs=l) field contains the Content-Type of the attachment. 

The /mylnbox/message/messageContent/attachment/content (base64Binary 
minOccurs=l maxOccurs=l) field contains the base64 encoded attachment content. 

The /mylnbox/message/messageContent/messagePart (minOccurs=0 
maxOccurs^unbounded) field contains the element and its children define the message 
structure (including the mime body). This element is returned by passing the 
'includeMessagePartStructure' element in query options. 

The /myInbox/message/messageContent/messagePart/@id (minOccurs=l 
maxOccurs=l) field contains the unique identifier of the messagePart. The 
/mylnbox/message/messageContent/messagePart/parentPart (minOccurs= 1 maxOccurs= 1 ) 
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element points to the parent part of this part. The 

/myInbox/message/messageContent/messagePart/parentPart/@ref (minOccurs=0 
maxOccurs=l) uuidType is used to specify a universally unique identifier (UUID). 

The /mylnbox/message/messageContent/messagePart/order (unsignedLong 
minOccurs=l maxOccurs=l) element defines the order of this part relative to its siblings. The 
/mylnbox/message/messageContent/messagePart/contentType (string minOccurs=l 
maxOccurs=l) element defines the content Type of the part, (for example, message/rfc or 
text/plain.a). 

The /mylnbox/message/messageContent/messagePart/size (unsignedLong minOccurs=l 
maxOccurs=l) field contains the size in bytes of the message part (including mime headers). 
The /mylnbox/message/messageContent/messagePart/contentDisposition (string minOccurs=0 
maxOccurs=l) element defines the content-disposition of the part, e.g., attachment; 
filename- 'txtl.txt" 

The /mylnbox/message/messageContent/messagePart/contentld (string minOccurs=0 
maxOccurs=l) element defines the content-id of the part. 

The /mylnbox/message/messageContent/messagePart/contentLocation (string 
minOccurs=0 maxOccurs=l) element defines the content-location of the part. 

The /mylnbox/message/messageContent/messagePart/contentTransferEncoding (string 
minOccurs=0 maxOccurs=l) element defines the content-transfer-encoding of this part. 

The /mylnbox/message/messageContent/messagePart/partContent (base64Binary 
minOccurs=0 maxOccurs=l) elements contains the content of this message part and is only 
returned by including the 4 includePart Content' element in the query options. 
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The /mylnbox/message/messageContent/preview (string minOccurs=0 maxOccurs=l) 
field contains the first 256 characters of the message body. This element is only returned if the 
query option 'includePreview' is specified, to allow clients to selectively implement a preview- 
like message function or not, e.g., thin clients may not want to download an entire message 
5 just for a quick view. The /myInbox/message/messageContent/preview/@xml:lang 

(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myInbox/message/messageContent/preview/@dir (string minOccurs=0 maxOccurs=l) 
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than downloading the message. The /myInbox/message/messageContent/single2822Header 
(string minOccurs=0 maxOccurs=unbounded) field contains the rfc2822 headers not included 
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'includeSingle2822Headers' element in query options. The 
/myInbox/message/messageContent/raw2822Content (base64Binary minOccurs=0 
maxOccurs=l) field contains the raw 2822 message (including headers and body) This element 
is returned by passing the includeRaw2822Contentelement in query options. The 
20 /myInbox/message/messageContent/raw2822Headers (base64Binary minOccurs=0 

maxOccurs=l) field contains the raw rfc2822 headers not included in the base schema (e.g., x- 
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apparently-to). This element is returned by passing the c includeRaw2822Headers' element in 
query options. 

The /myInbox/message/messageContent/{any} (minOccurs=0 maxOccurs=unbounded) 
field allows for extensibility. 

A draft is a message that has not been sent. A draft node is defined that is similar in 
many ways to that of a regular message node. However, certain things about a draft message 
are different from received or sent messages, such as that they may be edited, do not have a 
date sent or date received time. The shape of a draft message is different, as well, and draft 
messages are likely to change, and thus the draft schema includes many red nodes. 

In traditional email applications a draft message is stored in a Drafts folder and later 
sent. .NET Inbox allows for a draft to be stored in any folder. To this end, the /mylnbox/draft 
(minOccurs=0 maxOccurs=unbounded) element defines a single draft in mylnbox in the base 
schema. A draft represents an unsent email and is divided into two sub-groups 
'messageStatus' and 'messageContent'. The /myInbox/draft/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /myInbox/draft/@id (minOccurs=l maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services generates and 
assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
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the request message. After an ID has been assigned, the attribute is read only and attempts to 
write it are silently ignored. 

The /myInbox/draft/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. 

The /mylnbox/draft/draft Status (minOccurs=l maxOccurs=l) field contains the 
contents of this element represent the status metadata of the draft. 

The /mylnbox/draft/draft Status/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The/mylnbox/draft/draftStatus/isRead (boolean minOccurs=l maxOccurs=l) element 
defines the read/unread state of the message and can be modified. 

The /mylnbox/draft/draft Status/folder (minOccurs=l maxOccurs=l) element defines 
the single folder that this message logically belongs to. For drafts this may point to the drafts 
folder, but also may point to another folder, enabling drafts to be stored in another folder. 

The /mylnbox/draft/draft Status/folder/@ref (minOccurs=0 maxOccurs=l) uuidType is 
used to specify a universally unique identifier (UUID). 

The /mylnbox/draft/draft Status/flag (minOccurs=0 maxOccurs=l) optional element 
defines the flag state of the message. It includes an {any} element that can be used for 
extensible flags. 

The /mylnbox/draft/draft Status/flag/state (string minOccurs=l maxOccurs=l) field 
contains the state of a message flag. 
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The /mylnbox/draft/draft Status/flag/title (string minOccurs=l maxOccurs=l) field 
contains the client defined text of the flag. The /myInbox/draft/draftStatus/flag/title/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/mylnbox/draft/draft Status/flag/title/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
to left) and ltr (left to right). 

The /mylnbox/draft/draftStatus/flag/reminderDate (dateTime minOccurs=0 
maxOccurs=l) field contains the client defined reminder date of the flag. The 
/myInbox/draft/draftStatus/flag/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. The /mylnbox/draft/draft Status/state (string minOccurs=l maxOccurs=l) is an 
element, the value of which is 'draft'. It is provided for compatibility with messages. The 
/mylnbox/draft/draft Status/{ any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

The /mylnbox/draft/draftContent (minOccurs=l maxOccurs=l) element includes the 
contents that represent the content of the draft. The 

/myInbox/draft/draftContent/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 
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The /mylnbox/draft/draftContent/cat (minOccurs=0 maxOccurs=unbounded) element is 
used to categorize the element that contains it by referencing either a global category definition 
(in either the .NET Categories service system document or an external resource containing 
category definitions), or by referencing an identity-centered category definition in the content 
document of the .NET Categories service for a particular PUID. 

The /myInbox/draft/draftContent/cat/@ref (anyURI minOccurs=l maxOccurs=l) 
attribute references a category definition (catDef) element using the rules outlined in the .NET 
Categories section (my Categories) described above. 

The /mylnbox/draft/draft Content/account (minOccurs=l maxOccurs=l) element 
contains a reference to the /mylnbox/account element ref from which this message should be 
sent. 

The /myInbox/draft/draftContent/account/@ref (minOccurs=0 maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUID). 

The /mylnbox/draft/draftContent/draft Type (minOccurs=l maxOccurs=l) element 
includes subelements that describe the contents of the message. The 
/mylnbox/draft/draftContent/draft Type/type (string minOccurs=l maxOccurs=l) element 
contains a value that provides the client with enough information to render an 'Inbox' view of 
the messages. Valid values are 'voice', 'subscription', 'fax', 'dsn', 'readReceipt', 
'meetingResponse', 'meetingRequest', 'email' or 'liveEmaiF. The 

/mylnbox/draft/draftContent/draftType/contentType (string minOccurs=0 maxOccurs=l) field 
contains the contentType of the message (in accordance with RFC 2045). Examples of this 
are: 'text/plain' and 'multipart/mime'. 
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The /myInbox/draft/draftContent/draftType/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibility. 

The /mylnbox/draft/draft Content/size (unsignedLong minOccurs=l maxOccurs=l) read 
only element contains the size, in bytes, of the entire RFC2822 message in the store. 

The/mylnbox/draft/draftContent/importance (string minOccurs=l maxOccurs=l) 
element indicates the importance of this message. Valid values include 'low', 'normal 5 , or 
'high'. The default is 'normal'. 

The /mylnbox/draft/draftContent/sensitivity (string minOccurs=l maxOccurs=l) 
element indicates the sensitivity of the message. Valid values include 'normal', 'personal', 
'private', or 'confidential'. 

The/mylnbox/draft/draftContent/hasAttachments (boolean minOccurs=l 
maxOccurs=l) read only element indicates whether a message has one or more attachments. 
The value will either be 0 (to indicate that the message has no attachments) or 1 (to indicate 
that the message has one or more attachments). 

The /mylnbox/draft/draftContent/conversationld (string minOccurs=0 maxOccurs=l) 
optional element identifies the 'conversation,' or e-mail thread of which this message is a part. 

The /mylnbox/draft/draftContent/conversationlndex (string minOccurs=0 
maxOccurs=l) optional element identifies the 'conversation,' or e-mail thread of which this 
message is a part. 

The/mylnbox/draft/draftContent/subject (minOccurs=l maxOccurs^l) field contains 
the subject of the message. This element contains both a prefix and text sub-elements to allow 
clients to sort on the non-prefix part of the subject (so RE: RE: doesn't get sorted). The 
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/myInbox/draft/draftContent/subject/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draft/draftContent/subject/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and ltr (left to right). 

The /mylnbox/draft/draftContent/subject/prefix (string minOccurs=l maxOccurs=l) 
field contains the prefix of a message subject (e.g., TW: } ). 

The /mylnbox/draft/draftContent/subject/text (string minOccurs=l maxOccurs=l) field 
contains the subject of a message minus the prefix (e.g., 'hello there 5 ). 

The /mylnbox/draft/draft Content/from (minOccurs=l maxOccurs=l) read-only element 
describes who this message is from. To set this value, set the account element. 

The /mylnbox/draft/draft Content/from/name (string minOccurs=l maxOccurs=l) field 
contains the display name of an e-mail address. The 

/myInbox/draft/draftContent/from/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draft/draftContent/from/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and ltr (left to right). 

The/mylnbox/draft/draftContent/from/email (string minOccurs=l maxOccurs=l) field 
contains an e-mail address (for example, someone@microsoft.com). 
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The /mylnbox/draft/draftContent/recipient (minOccurs=0 maxOccurs=unbounded) field 
specifies the recipient of this message and where they appear. 

The /myInbox/draft/draftContent/recipient/@type (string minOccurs=l maxOccurs=l) 
field specifies whether the recipient is in the 'to\ 'cc' or 'bcc' list. 

The/mylnbox/draft/draftContent/recipient/name (string minOccurs=l maxOccurs=l) 
field contains the display name of an e-mail address. The 

/myInbox/draft/draftContent/recipient/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draft/draftContent/recipient/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/draft/draftContent/recipient/email (string minOccurs=l maxOccurs^l) 
field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/draft/draftContent/plainBody (string minOccurs=0 maxOccurs=l) field 
contains the plain body representation of the draft. The /mylnbox/draft/draftContent/htmlBody 
(minOccurs=0 maxOccurs=l) field contains the html body representation of the draft. This 
element can optionally contain inline attachments. The 

/mylnbox/draft/draftContent/htmlBody/body (string minOccurs=l maxOccurs=l) field contains 
the contents of the body. The /mylnbox/draft/draftContent/htmlBody/inlineAttachment 
(minOccurs=0 maxOccurs=unbounded) element represents an inline attachment. 



-54- 



The /mylnbox/draft/draftContent/htmlBody/inlineAttachment/uri (string minOccurs=l 
maxOccurs=l) field contains the client-defined unique identifier for the inline attachment. This 
element is used to identify this attachment location within the html body of a message. 

The /mylnbox/draft/draftContent/htmlBody/inlineAttachment/contentType (string 
minOccurs=l maxOccurs=l) field contains the Content-Type of the attachment. The 
/mylnbox/draft/draftContent/htmlBody/inlineAttachment/content (base64Binary minOccurs=l 
maxOccurs=l) field contains the base64 encoded attachment content. The 
/mylnbox/draft/draftContent/attachment (minOccurs=0 maxOccurs=unbounded) element 
represents a mail attachment. 

The /mylnbox/draft/draftContent/attachment/name (string minOccurs=l maxOccurs=l) 
field contains the client defined name of the attachment. The 

/mylnbox/draft/draftContent/attachment/ord (unsignedLong minOccurs=l maxOccurs=l) 
specifies the unique order that this attachment should appear relative to all other attachments. 
The /mylnbox/draft/draftContent/attachment/contentType (string minOccurs=l maxOccurs=l) 
provides he Content-Type of the attachment. 

The /mylnbox/draft/draftContent/attachment/content (base64Binary minOccurs=l 
maxOccurs=l) comprises the base64 encoded attachment content. The 
/mylnbox/draft/draftContent/draftPart (minOccurs^l maxOccurs=unbounded) element and its 
children define the message structure (including the mime body). 

The /myInbox/draft/draftContent/draftPart/@changeNumber (minOccurs=l 
maxOccurs^l) changeNumber attribute is designed to facilitate caching of the element and its 
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descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /my Inbox/draft/draft Content/draftPart/parentPart (minOccurs=l maxOccurs=l) 
element points to the parent part of this part. The 

/myInbox/draft/draftContent/draftPart/parentPart/@ref (minOccurs=0 maxOccurs= 1 ) 
uuidType is used to specify a universally unique identifier (UUID). 

The /mylnbox/draft/draftContent/draftPart/order (unsignedLong minOccurs=l 
maxOccurs=l) element defines the order of this part relative to its siblings. The 
/mylnbox/draft/draftContent/draftPart/contentType (string minOccurs=l maxOccurs=l) 
element defines the contentType of the part, (e.g., message/rfc or text/plain. a). 

The /mylnbox/draft/draftContent/draftPart/size (unsignedLong minOccurs=l 
maxOccurs=l) field contains the size in bytes of the message part (including mime headers). 
The /mylnbox/draft/draftContent/draftPart/contentDisposition (string minOccurs=0 
maxOccurs=l) field contains the element defines the content-disposition of the part ex: 
attachment; filename-'txtl.txt". The /mylnbox/draft/draftContent/draftPart/contentld (string 
minOccurs=0 maxOccurs=l) element defines the content-id of the part. The 
/mylnbox/draft/draftContent/draftPart/contentLocation (string minOccurs=0 maxOccurs=l) 
element defines the content-location of the part. 

The/mylnbox/draft/draftContent/draftPart/contentTransferEncoding (string 
minOccurs=0 maxOccurs=l) element defines the content-transfer-encoding of this part. The 
/mylnbox/draft/draftContent/draftPart/partContent (base64Binary minOccurs=l 
maxOccurs=l) elements contain the content of this message part. The 
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/myInbox/draft/draftContent/draftPart/{any} (minOccurs=0 maxOccurs=unbounded) field 
allows for extensibility. 

The /mylnbox/draft/draftContent/preview (string minOccurs=0 maxOccurs=l) field 
contains the first 256 characters of the message body. This element is only returned if the 
5 query option 'includePreview' is specified. The 

/myInbox/draft/draftContent/preview/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draft/draftContent/preview/@dir (string minOccurs=0 
10 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

jU Valid values are rtl (right to left) and ltr (left to right). 

II] 

CR The /myInbox/draft/draftContent/single2822Header (string minOccurs=0 

iy 

J maxOccurs=unbounded) field contains the rfc2822 headers not included in the base schema 

o 

iy (e.g., x-apparently-to). This element is returned by passing the 'includeSingle2822Headers' 

IU 

q 15 element in query options. 

The /myInbox/draft/draftContent/raw2822Content (base64Binary minOccurs=0 
maxOccurs=l) field contains the raw 2822 message (including headers and body) This element 
is returned by passing the includeRaw2822Contentelement in query options. The 
/myInbox/draft/draftContent/raw2822Headers (base64Binary minOccurs=0 maxOccurs=l) 
20 field contains the raw rfc2822 headers not included in the base schema (e.g., x-apparently-to). 
This element is returned by passing the 4 includeRaw2822Headers 5 element in query options. 
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The /myInbox/draft/draftContent/{any} (minOccurs=0 maxOccurs=unbounded) and the 
/myInbox/draft/{any} (minOccurs=0 maxOccurs=unbounded) fields allow for extensibility. 

The /mylnbox/rule (minOccurs=0 maxOccurs=unbounded) field contains rules that 
specify actions that should be performed on the active message during sending or delivery. 
For example, certain messages may be moved to a particular folder via a rule, while out-of- 
office is also implemented via rule. The /myInbox/rule/@sequence (unsignedLong 
minOccurs=l maxOccurs=l) required attribute specifies the order in which this action should 
be performed, relative to other actions for this rule. 

Most email applications allow for rules, however rules expressed by one email 
application normally cannot be consumed by another application, forcing each client to invent a 
new storage mechanism. In .NET Inbox there is a single schema for how a rule is stored. For 
example, the sample schema table below would move new messages with the importance set to 
high to the Important mail folder: 



<myInbox> 

<folderid="123> 

<name xml:lang="en">Iniportant</name> 
</folder> 
<rule> 

<name xml:lang="en">Move high priority email to Important folder</name> 

<enabled>True</enabled> 

<runat>server</runat> 

<condition 

select-'. /importance = c high'"> 
</condition> 
<action> 

<moveMessage> 

<targetFolderref="1237> 

</moveMessage> 
</action> 

</rule> 

</my!nbox> 
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Expressing this rule structure in XML allows all clients to know what the rules are and 
which are run by the server and which by the client. 

The /myInbox/rule/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/rule/@id (minOccurs^l maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services generates and 
assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. After an ID has been assigned, the attribute is read only and attempts to 
write it are silently ignored. 

The /myInbox/rule/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. The /mylnbox/rule/name (string 
minOccurs=l maxOccurs=l) field contains the application-defined, human readable identifier 
of the rule. The /myInbox/rule/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/rule/name/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values are 
rtl (right to left) and Itr (left to right). 
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The /mylnbox/rule/state (string minOccurs=l maxOccurs=l) field indicates whether the 
rule represented by this node is currently enabled. The /mylnbox/rule/runat (string 
minOccurs=l maxOccurs=l) required attribute specifies where the rule must run. For 
example, rules may be run at a server, wherein the value is 'server 5 , or may be run at a client. 

The /mylnbox/rule/runwhen (string minOccurs=l maxOccurs=l) required attribute 
specifies when the rule must run. Allowable values include 'sending' and 'receiving'. 

The /mylnbox/rule/type (string minOccurs=l maxOccurs=l) field specifies if this is of 
type 'oof or 'normal'. 

The /mylnbox/rule/provider (string minOccurs=l maxOccurs=l) field contains the 
application-defined provider of the rule. This is provided so that multiple applications can (if 
they so desire) only alter their own rules. The /myInbox/rule/provider/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The /myInbox/rule/provider/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/rule/condition (minOccurs=l maxOccurs=l) element's select attribute 
specifies the xpath expression used to evaluate if this rule applies to the active message. The 
/myInbox/rule/condition/@select (string minOccurs=l maxOccurs=l) attribute specifies an 
xpath expression used to determine if this rule applies to the active message. Because rules 
only apply to messages, this statement must be scoped to the message element. Valid 
examples include "/importance = 'high'"; "/from/email = 'someone@microsoft.com' and 
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contains (./subject/full, 'hello')". Examples of invalid statements include 
u /myInbox/message[./importance = 'high']"; "/mylnbox/folder"; "/mylnbox/rule". 

The /mylnbox/rule/action (minOccurs=l maxOccurs=unbounded) field specifies an 
individual action to perform if the select element matches minOccurs-maxOccurs messages. 
The /myInbox/rule/action/@sequence (unsignedLong minOccurs=l maxOccurs=l) required 
attribute specifies the order that this action should be performed in relative to all other actions 
for this rule. The /mylnbox/rule/action/copyMessage (minOccurs=0 maxOccurs=l) action is 
used to copy the active message in rules processing to another folder specified by the 
HargetFolder' element. 

The /mylnbox/rule/action/copyMessage/targetFolder (minOccurs=l maxOccurs=l) 
element specifies the folder to save the message to. If omitted, the message is saved in the 
drafts folder. The /myInbox/rule/action/copyMessage/targetFolder/@select (string 
minOccurs=l maxOccurs=l) field contains the location of the folder to which save the 
message. For example, The /myInbox/folder[@id- "']. 

The /mylnbox/rule/action/moveMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should be moved to the targetFolder. The 
/mylnbox/rule/action/moveMessage/targetFolder (minOccurs=l maxOccurs=l) element 
specifies the folder to save the message to. If omitted, the message is saved in the drafts 
folder. 

The /myInbox/rule/action/moveMessage/targetFolder/@select (string minOccurs=l 
maxOccurs=l) field contains the location of the folder to which save the message. For 
example, The /myInbox/folder[@id=""]. 
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The /mylnbox/nile/action/deleteMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should be deleted. The 

/mylnbox/rule/action/assignCategory (minOccurs=0 maxOccurs=l) field is used in rule actions 
to indicate that the active message should have the included cat element added to it. 

The /mylnbox/rule/action/assignCategory/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing either a global 
category definition (in either the .NET Categories service system document or an external 
resource containing category definitions), or by referencing an identity-centered category 
definition in the content document of the .NET Categories service for a particular PUID. 

The /myInbox/rule/action/assignCategory/cat/@ref (anyURI minOccurs=l 
maxOccurs=l) attribute references a category definition (catDef) element using the rules 
outlined in the .NET Categories section (myCategories) described above. 

The /mylnbox/rule/action/forwardMessage (minOccurs=0 maxOccurs=l) field is used 
in rule actions to indicate that the active message should be forwarded to the included 
recipients. The /mylnbox/rule/action/forwardMessage/recipient (minOccurs=0 
maxOccurs=unbounded) field specifies an e-mail address and display name, or the PUID that 
represents them. 

The /myInbox/rule/action/forwardMessage/recipient/@type (string minOccurs=l 
maxOccurs=l) field specifies whether the recipient is in the 'to', 'cc' or 'bcc' list. 

The /mylnbox/rule/action/forwardMessage/recipient/name (string minOccurs=l 
maxOccurs=l) field contains the display name of an e-mail address. The 
/myInbox/rule/action/forwardMessage/recipient/name/@xml:lang (minOccurs=l 
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maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The 

/myInbox/rule/action/forwardMessage/recipient/name/@dir (string minOccurs=0 
5 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and ltr (left to right). The 

/mylnbox/rule/action/forwardMessage/recipient/email (string minOccurs=l maxOccurs=l) 
field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/rule/action/forward As Attachment (minOccurs=0 maxOccurs=l) field is 

P 10 used in rule actions to indicate that the active message should be forwarded to the included 

P 



recipients as an attachment. The /mylnbox/rule/action/forwardAsAttachment/recipient 



IP (minOccurs=0 maxOccurs=unbounded) field specifies an e-mail address and display name, or 

Id 

a the PUID that represents them. The 

iij 



/mylnbox/rule/action/forward As Attachment/recipient/@type (string minOccurs=l 



jj'ljj 15 maxOccurs=l) field specifies whether the recipient is in the 'to', 'cc' or 'bcc 5 list. 

13 



The /mylnbox/rule/action/forward As Attachment/recipient/name (string minOccurs=l 
maxOccurs=l) field contains the display name of an e-mail address. The 
/mylnbox/rule/action/forward As Attachment/recipient/name/@xml Jang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
20 country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The 

/myInbox/rule/action/forwardAsAttachment/recipient/name/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/rule/action/forward As Attachment/recipient/email (string minOccurs=l 
maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 
5 The /mylnbox/rule/action/serverReply (minOccurs=0 maxOccurs=l) field, if present, 

includes the /mylnbox/rule/action/serverReply/subject (minOccurs=l maxOccurs=l) field 
which contains the subject of the message from the server. The 

/myInbox/rule/action/serverReply/subject/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

§4? 

o 

II 10 described in RFC 1766. The value of this attribute indicates the language type of the content 

IU 

y 5 within this element. The /myInbox/rule/action/serverReply/subject/@dir (string minOccurs=0 

in 

III maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

W 

: Valid values are rtl (right to left), and ltr (left to right). 

jjj The /mylnbox/rule/action/serverReply/subject/prefix (string minOccurs=l 

IU 

q 15 maxOccurs=l) field contains the prefix of a message subject (e.g., TW: '). The 

/mylnbox/rule/action/serverReply/subject/text (string minOccurs=l maxOccurs=l) field 
contains the subject of a message, minus the prefix (e.g., 'hello there'). 

The /mylnbox/rule/action/serverReply/simpleBody (string minOccurs=l maxOccurs=l) 
field contains a plain text simple body that should be sent from the server. The 
20 /myInbox/rule/action/serverReply/simpleBody/@xml:lang (minOccurs=l maxOccurs=l) 

required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
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within this element. The /myInbox/rule/action/serverReply/simpleBody/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/rule/action/redirectMessage (minOccurs=0 maxOccurs=l) field is used 
in rule actions to indicate that the active message should be redirected to the included 
recipient. The /mylnbox/rule/action/redirectMessage/recipient (minOccurs=0 
maxOccurs=unbounded) field specifies an e-mail address and display name, or the PUID that 
represents them. The /myInbox/rule/action/redirectMessage/recipient/@type (string 
minOccurs=l maxOccurs=l) specifies whether the recipient is in the 'to', 'cc' or 'bcc' list. 

The /mylnbox/rule/action/redirectMessage/recipient/name (string minOccurs=l 
maxOccurs=l) field contains the display name of an e-mail address. The 
/myInbox/rule/action/redirectMessage/recipient/name/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/rule/action/redirectMessage/recipient/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). 

The /mylnbox/rule/action/redirectMessage/recipient/email (string minOccurs=l 
maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/rule/action/flagMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should have the included flag added to it. The 
/mylnbox/rule/action/flagMessage/flag (minOccurs=l maxOccurs=l) optional element defines 
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the flag state of the message. It includes an {any} element that can be used for extensible 
flags. 

The/mylnbox/rule/action/flagMessage/flag/state (string minOccurs=l maxOccurs=l) 
field contains the state of a message flag. The /mylnbox/rule/action/flagMessage/flag/title 
5 (string minOccurs=l maxOccurs=l) field contains the client-defined text of the flag. The 
myInbox/rule/action/flagMessage/flag/title/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/rule/action/flagMessage/flag/title/@dir (string minOccurs=0 

P 10 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

fU 

M, Valid values are rtl (right to left) and ltr (left to right). 

in 

111 The /mylnbox/rule/action/flagMessage/flag/reminderDate (dateTime minOccurs=0 

W 

J maxOccurs=l) field contains the client-defined reminder date of the flag. The 

13 

fii /myInbox/rule/action/flagMessage/flag/{any} (minOccurs=0 maxOccurs=unbounded) field 

IU 

q 15 allows for extensibility. 

H 

The /mylnbox/rule/action/markAsRead (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should be marked as read. The 
/mylnbox/rule/action/stopProcessingRulesOfThisType (minOccurs=0 maxOccurs=l) is 
directed to stopping certain rules from processing, e.g., if a rule has already handled a received 
20 message, certain other rules should not process it. 

The /myInbox/rule/{any} (minOccurs=0 maxOccurs-unbounded) field allows for 
extensibility. 
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HI 



The mylnbox content document include a subscription node that essentially takes 
action when items change, such as to propagate information about the change to other 
services. 

The /mylnbox/subscription (minOccurs=0 maxOccurs=unbounded) element defines a 
subscription node that is designed to be an xdb.blue node which when placed in a content 
document causes a subscription to be registered, (wherein as used herein, the string "mylnbox" 
referred to in this section can be replaced by an appropriate service name, e.g., 
"myApplicationSettings" or "mylnbox" or "myWallet" and so forth). A subscription contains a 
trigger element which selects a scope of coverage. When items that are under this scope of 



P 10 coverage change, a subscriptionResponse message is generated and sent to the specified 

fU 

destination address. 



The /myInbox/subscription/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system, and the attribute is 



P 15 read-only to applications; attempts to write this attribute are silently ignored. 

The /myInbox/subscription/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services will generate and 
assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
20 the request message. Once an ID is assigned, the attribute is read-only and attempts to write it 
are silently ignored. 
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The /myInbox/subscription/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
/mylnbox/subscription/trigger (minOccurs=l maxOccurs=l) includes the 
/myInbox/subscription/trigger/@select (string minOccurs=0 maxOccurs=l) item, which 
5 specifies an XPATH expression that specifies the nodes that are to be selected and watched for 
changes. The selection may only select xdb:blue nodes, as described above. A s changes in 
this node set occur, they trigger the generation of a subscription message. These messages are 
then sent to the SOAP receiver listed in the "to" element. 
, The /myInbox/subscription/trigger/@mode (string minOccurs=0 maxOccurs=l) 

1 4i 

p 10 attribute specifies whether or not the content of the changes that triggered the subscription are 

ru 

|* delivered in the subscription message, or if the message simply indicates that something 

in 

SH changed under the trigger. The attribute may comprise includeData, namely that the data that 

14 



changed and caused the subscription to trigger is included in the subscription message. Note 



lit that deleted nodes are specified by their id, not by value. Alternatively the attribute may 

fU 

P 15 comprise excludeData, whereby the data that changed, causing the subscription to trigger, is 



not included in the subscription message. 

The /myInbox/subscription/trigger/@baseChangeNumber (minOccurs=0 
maxOccurs=l) attribute specifies the changeNumber value that the trigger is relative to. All 
changes between the specified change number, and the current state of the document relative 
20 to the selection are transmitted as subscription messages. This allows a client application to 
establish a subscription relative to some baseline. As in changeQuery, if the 
baseChangeNumber is way out of date relative to the current state of the document, and the 
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service can not supply the changes in the subscription message, the subscription insert is 
rejected. A value of zero (0) means that the current values of the selected nodes are 
transmitted in the subscription message. 

The /mylnbox/subscription/expiresAt (dateTime minOccurs^O maxOccurs=l) 
optional element specifies an absolute time after which the subscription is no longer active. 
The subscription node is automatically removed when the subscription expires. If this element 
is missing, the subscription does not expire. The /mylnbox/subscript ion/context (minOccurs=l 
maxOccurs=l) element returns the context element from the original subscription. 
Applications should use this element to correlate the subscription response with one of their 



q 10 subscriptions. 



The /myInbox/subscription/context/@uri (anyURI minOccurs=0 maxOccurs=l) 

in 

H attribute specifies the URI value chosen by the subscriber that is associated with this 



subscription. The /myInbox/subscription/context/{any} (minOccurs=0 
maxOccurs=unbounded) including the /mylnbox/subscription/to (anyURI minOccurs=l 



IU 

n 15 maxOccurs=l) attribute specifies the location that is to receive the subscription message. The 

u 

value of this element may be hs:my Alerts, whereby this URI indicates that generated 
subscription messages are to be delivered inside the body of a notification and delivered to the 
default .NET Alerts service of the creator. Alternatively, the value may be protocol ://service, 
whereby this URI indicates that generated subscription messages are delivered to the specified 
20 service at the domain of the creator's platformld. For example, a platformld indicating 

microsoft.com, and a value in this element of http://subscriptionResponse would cause delivery 
of the subscription message to http://subscriptionResponse.microsoft.com. If this value is not 
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specified, then the subscription message is delivered as a notification to the "creator's" .NET 
Alerts service. The /myInbox/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

^^ ^Mylnbox /System 

The system document is a global document for each service, having content and 
meaning that is independent of the puid used to address the service. The document is read 
only to all users. Each system document contains a set of base items common to each of the 
^ .NET My Services described herein, and is optionally extended by each service to include 

|| 10 service-specific global information. The following schema outline illustrates the layout and 

IU 

H meaning of the information found in the mylnbox system document: 

in 

In 

o 
ru 
ru 
a 
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TABLE - /*actual service name*/ system 



<svs:svstem chaneeNumber=" ..." instanceld=" ..." 




xmlns:hs=" http://schemas.microsoft.com/hs/200 1/10/core" 




xmlns:sys=" http://schemas.microsoft.com/hs/2001/10The /*actual service name*/system" >u 


<hs:svstemVersion chaneeNumber=" ..." id=" ..." creator=" ..." >i i 




<hs:version majorVersion=" ..." minorVersion=" ..." buildNumber=" ..." 


qfe=". ..">i., 


<hs:productReleaseName>i.i</lis:productReleaseName> 




<hs : productlmplementat ionName> i , i </hs : productImplementationName> 




</hs:version> 




<hs:buildDate>i.i</hs:buildDate> 




<hs:buildDetails machine^'..." branch=" ..." type=".." official" ..." > 


. i</hs:buildDetails> 


</hs:systemVersion> 




<hs:roleMaD chaneeNumber- ' ..." id=" . ." creator- 6 ..." >i i 




<hs:SCOpe id=" ..." >0..unbounded 




<hs:name xml:lang- ' ..." dir=" ..." >o..unbounded</hs:name> 




<hs:shape base-' ..." >i..i 




<hs: include select=" ..." >o..unbounded</hs:include> 




<hs:exclude select-' ..." >o..unbounded</hs:exclude> 




</hs:shape> 




</hs:scope> 




<hs:roleTemplate name=" ..." priority-' ..." >o. unbounded 




<hs:fullDescription xml:lang=" ..." dir=" ..." > 0 ..i</hs:fullDescription> 




<hs:method name=" ..." scopeRef^" ..." >o.. U nbounded < /hs:method> 




</hs : roleTemplate> 




</hs:roIeMap> 




<hs:methodMao chaneeNumber-' ..." id=" ..." creator-' ...">] i 




<hs:method name- ' ..." >o..unbounded /tf/?j{/</hs:method> 




</hs:methodMap> 




<hs:schemaMap chanseNumber=" ..." id=" ..." creator=" ..." >i i 




<hs:schema namespace- £ ..." schemaLocation=" ..." alias=" ..." >o..unbounded /tfflj>/</hs:schema> 


</hs:schemaMap> 




<hs:wsdlMao chaneeNumber- * ..." id=" ..." creator- 6 ..." >i i 




<hs:wsdl wsdlLocation=" ..." >o..unbounded {any}</hs:wsdl> 




<hs:disco discoLocation- ' ..." >o..unbounded /a/fj{/</hs:disco> 




<hs:wsil wsilLocation-' ..." ^.unbounded /tf/y>/</hs:wsil> 




</hs:wsdlMap> 




</any> 




</sys:system> 





The meaning of the attributes and elements shown in the preceding sample document 
outline follow, beginning with /system (minOccurs=l maxOccurs=l), the element that 
5 encapsulates a system document common to the various services. Although each service has 
its own system document, the common system document attributes and elements are described 
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once, for purposes of simplicity, with service-specific system document attributes and elements 
specified for each service, below. The /system/@changeNumber (minOccurs=0 maxOccurs=l) 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
5 applications. Attempts to write this attribute are silently ignored. 

The /system/@instanceld (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 
^ The /system/systemVersion (minOccurs=l maxOccurs=l) element defines version 

b 

q 10 information describing this instance of the .NET MyServices service. The 

ru 

M /system Version/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber attribute is 

In 

designed to facilitate caching of the element and its descendants. This attribute is assigned to 



B 



I ^ this element by the .NET My Services system. The attribute is read-only to applications; 

O 

iy attempts to write this attribute are silently ignored, (e.g., without generating an error). 

ru 

Q 15 The /system/system Version/@id (minOccurs=0 maxOccurs=l) attribute is a globally 



unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
20 and attempts to write it are silently ignored. 

The /system/system Version/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
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/system/system Version/version (minOccurs=l maxOccurs=l) element defines major, minor, 
and build number version information. The /system/systemVersion/version/@majorVersion 
(string minOccurs=0 maxOccurs=l) attribute specifies the major version number of the .NET 
MyServices service. 

5 The /system/system Version/version/@minorVersion (string minOccurs=0 

maxOccurs=l) attribute specifies the minor version number of the .NET MyServices service. 
The /system/systemVersion/version/@buildNumber (string minOccursO maxOccurs=l) 
attribute specifies the buildNumber of the .NET MyServices service. The 
. . /system/systemVersion/version/@qfe (string minOccurs=0 maxOccurs=l) attribute specifies 

P 

q 10 the qfe version number of the .NET MyServices service. The 

ry- 

H /system/system Version/version/productReleaseName (string minOccurs=l maxOccurs=l) 

in 

$ TSl. 

p element defines the major product release string (as in .NET My Services Beta 1, and so on). 

The /system/systemVersion/version/productlmplementationName (anyURI minOccurs=l 

13 

f§ j maxOccurs=l) element defines the class of the service to differentiate between different 

fij 

O 15 implementations. 

J* 

The /system/sy stem Version/buildDate (dateTime minOccurs=l maxOccurs=l) element 
defines the date and time that the .NET My Services system was built. The time is in UTC (Z 
relative) form. The /system Version/buildDetails (minOccurs=l maxOccurs=l) element defines 
details of the build including the machine that generated the build, the branch id of the software 
20 that contributed to the build, the type of build (chk/fre), and if the build was generated by an 
official build release process. 
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The /system/system Versior^uildDetails/@machine (string minOccurs=0 
maxOccurs=l) attribute specifies the machine that generated the build. The 
system/system Version/buildDetails/@branch (string minOccurs=0 maxOccurs=l) attribute 
specifies the software branch id for the source code that contributed to this build. The 
5 /system/system Version/buildDetails/@type (string minOccurs=0 maxOccurs=l) attribute 
specifies the type of build. A value of chk indicates that this is a checked or debug build. A 
value of fre indicates that this is a retail build. The 

/system/systemVersioa^uildDetails/@ofFicial (string minOccurs=0 maxOccurs=l) attribute 
5 indicates that the build was produced by an official build process (value of yes), or an unofficial 

is 

p 10 process (value of no). 

m 

I* The /system/roleMap (minOccurs=l maxOccurs=l) element encapsulates all the 

m 

W elements that make up a roleMap, which include document class relative roleTemplate, 

J priority, name, method, and per-method scope. An individual roleTemplate defines the 

jji "59 

C3 

m maximum scope of information, and the allowable methods used to access that information for 

ru 

p 15 each request mapped into the template. The /system/roleMap/@changeNumber (minOccurs=0 
maxOccurs=T) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. The 
/system/roleMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID assigned 
20 to this element by .NET My Services. Normally, .NET My Services will generate and assign 
this ID during an insertRequest operation, or possibly during a replaceRequest. Application 
software can override this ID generation by specifying the useClientlds attribute in the request 
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message. Once an ID is assigned, the attribute is read-only and attempts to write it are silently 
ignored. 

The /system/roleMap/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appld, and platformld of the node. The /system/roleMap/scope 
5 (minOccurs=0 maxOccurs=unbounded) element defines a scope which may be referred to by 
roles within this roleMap to indicate what portions of the document are visible to this role for 
the specified method. 

The /system/roleMap/scope/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
^ unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 

q 

p 10 generate and assign this ID during an insertRequest operation, or possibly during a 

IU 



01 

m 



replaceRequest. Application software can override this ID generation by specifying the 

useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 

W 

^ and attempts to write it are silently ignored. The /system/roleMap/scope/name (string 

u 

fy minOccurs=0 maxOccurs=unbounded) node includes the 

IU 

O 15 /system/roleMap/scope/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute, 

which is used to specify an ISO 639 language code or an ISO 3 166 country code as described 
in RFC 1766. The value of this attribute indicates the language type of the content within this 
element. The /system/roleMap/scope/name/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl (right 
20 to left), and ltr (left to right). 

The /system/roleMap/scope/shape (minOccurs=l maxOccurs=l) comprises a shape that 
defines the node set that is visible through the document when operating through this shape 
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element. The /system/roleMap/scope/shape/@base (string minOccurs=0 maxOccurs=l) 
attribute specifies the initial set of nodes visible through the shape. A value oft indicates that 
the shape is initialized to include all possible nodes relative to the shape that is currently in 
effect. For instance, each role defines a scope containing a shape. When defining a shape for a 
5 role, the value t indicates all possible nodes available in the specified document for this role. 
When defining a shape in an ACL entry, a value of t means all of the nodes visible in the shape 
for the computed role. When using a shape in a data language (e.g., query, insert, replace and 
so on) operation, a value of t indicates all of the possible nodes selected by the data language 

g ^ operation (relative to the ACL shape which itself is relative to the role's shape). The value nil 

p 

P 10 indicates the opposite of t, which is the empty node set. Nodes from this set may then be 

IU 

I* included into the shape. 

in 

(R The /system/roleMap/scope/shape/include (minOccurs=0 maxOccurs=unbounded) 

Isj - 

I j element specifies the set of nodes that should be included into the shape relative to the possible 

(3 

iy set of nodes indicated by the base attribute. The /system/roleMap/scope/shape/include/@select 

fU 

a 15 (string minOccurs=0 maxOccurs=l) item specifies an XPATH expression that selects a set of 

ft 

nodes relative to the externally established context. The expression can never travel outside 
the node-set established by this externally established current context. The expression may 
match zero or more nodes, and the operation manipulates all selected nodes. The minOccurs 
and maxOccurs attributes are optional and place restrictions and limitations on the number of 
20 nodes selected. 



The /system/roleMap/scope/shape/exclude (minOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be excluded from the shape relative to the 
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possible set of nodes indicated by the base attribute. The 

/system/roleMap/scope/shape/exclude/@select (string minOccurs=0 maxOccurs=l) item 
specifies an XPATH expression that selects a set of nodes relative to the externally established 
context. The expression can never travel outside the node-set established by this externally 
5 established current context. The expression may match zero (0) or more nodes, and the 
operation manipulates all selected nodes. The minOccurs and maxOccurs attributes are 
optional and place restrictions and limitations on the number of nodes selected. The 
/system/roleMap/roleTemplate (minOccurs=0 maxOccurs=unbounded) element encapsulates 
m the definition of a role. The attribute set for this element includes the document class that this 

I j 10 roleTemplate refers to, the name of the roleTemplate, and the priority of the roleTemplate. 

fU 

\+ The /system/roleMap/roleTemplate/@name (string minOccurs=0 maxOccurs=l) 

!H 

y s element specifies the name of the role. The /system/roleMap/roleTemplate/@priority (int 

l?J 

t A minOccurs=0 maxOccurs=l) element specifies the priority of the roleTemplate which is used 

P 

ly to select that actual roleTemplate when the role evaluation determines that the subject maps to 

ry 

fj 15 multiple roleTemplates. 

The /system/roleMap/roleTemplate/fullDescription (string minOccurs=0 
maxOccurs=l) element contains a description of this role template which specifies the 
capabilities a caller will have when accessing information through this role. The 
/system/roleMap/roleTemplate/fullDescription/@xml:lang (minOccurs=l maxOccurs=l) 
20 required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /system/roleMap/roleTemplate/fullDescription/@dir (string 
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minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and ltr (left to right). 

The /system/roleMap/roleTemplate/method (minOccurs=0 maxOccurs=unbounded) 
element specifies the methods available within this roleTemplate by name, and by scope. When 
5 a subject maps to a roleTemplate, the method in the request must match one of these elements 
for the message to continue to flow. If the method exists, the data available to the method is a 
function of the scope referenced by this method combined with an optional scope referenced 
by the role defined in the roleList. 
g , The /system/roleMap/roleTemplate/method/@name (string minOccurs=0 

jjiSUS ~ " * """"" 

o 

q 10 maxOccurs=l) element specifies the name of the method. The 

ru 

I* /system/roleMap/roleTemplate/method/@scopeRef (string minOccurs=0 maxOccurs=l) 

m 

pj attribute specifies the scope within this document that is in effect for this method. The 

I . /system/methodMap (minOccurs=l maxOccurs=l) element defines the methodMap. While in 

13 

|y most cases, the roleMap section contains a definitive list of methods, these methods are likely 

ry 

p 15 to be scattered about the roleMap in various templates. This section contains the definitive 

ii 

non-duplicated list of methods available within the service. 

The /system/methodMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
20 read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/methodMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
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generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. The /system/methodMap/@creator (string 
5 minOccurs=0 maxOccurs=l) attribute identifies the creator in terms of userld, appld, and 
platformld of the node. 

The /system/methodMap/method (minOccurs=0 maxOccurs=unbounded) element 
defines a method that is available within this service. The /system/methodMap/method/@name 
(string minOccurs=0 maxOccurs=l) attribute specifies the name of a method available within 

p 

p 10 the service. The/system/methodMap/method/{any} (minOccurs=0 maxOccurs=unbounded) 

\& provides for extensibility. The /system/schemaMap (minOccurs=l maxOccurs=l) element 

Iff 

Ift defines the various schema's that define the data structures and shape of information managed 

iy 

fl 3 by this service. Each schema is defined by its namespace URI, its location, and a preferred 

H 

1 3 

$u namespace alias. 

IU 

p 1 5 The /system/schemaMap/@changeNumber (minOccurs=0 maxOccurs= 1 ) 

H 

changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/schemaMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
20 unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
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useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /system/schemaMap/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appld, and platformld of the node. The 
/system/schemaMap/schema (minOccurs=0 maxOccurs=unbounded) element defines a schema 
which defines data-structures and the shape of information managed by this service. Multiple 
schema elements exist for each service, once for each logical grouping of information exposed 
by the service. The /system/schemaMap/schema/@namespace (anyURI minOccurs=0 
maxOccurs=l) attribute specifies the namespace URI of this schema. The 
/system/schemaMap/schema/@schemaLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute specifies the location (in the form of a URI) of the resource containing schema. 
When a schema is reachable through a variety of URIs, one schema element will exist for each 
location. 

The /system/schemaMap/schema/@alias (string minOccurs=0 maxOccurs=l) attribute 
specifies the preferred alias that should be used if possible when manipulating information 
covered by this schema in the context of this service. The /system/schemaMap/schema/{any} 
(minOccurs=0 maxOccurs=unbounded) provides for extensibility. The /system/wsdlMap 
(minOccurs=l maxOccurs=l) element defines the wsdlMap for this service. This map includes 
the location of WSDL documents, DISCO documents, and WSIL documents for this web 
service. These documents are used by applications to understand the format of messages that 
may be sent to the various services. The /system/wsdlMap/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
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descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/wsdlMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
ED assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute in 
the request message. Once an ID is assigned, the attribute is read-only and attempts to write it 
are silently ignored. The /system/wsdlMap/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appld, and platformld of the node. 

The /system/wsdlMap/wsdl (minOccurs=0 maxOccurs=unbounded) element is used to 
specify the location of a WSDL file for this service. Multiple entries may exist pointing to the 
same file hosted in multiple locations, or to variations on the content within the WSDL files. 

The /system/wsdlMap/wsdl/@wsdlLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute is a URI that specifies the location of the WSDL file. The 
/system/wsdlMap/wsdl/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibility. 

The /system/wsdlMap/disco (min0ccurs=O maxOccurs=unbounded) element is used to 
specify the location of a DISCO (web-services discovery) file for this service. Multiple entries 
may exist pointing to the same file hosted in multiple locations, or to variations on the content 
within the DISCO files. The /system/wsdlMap/disco/@discoLocation (anyURI minOccurs=0 
maxOccurs=l) attribute is a URI that specifies the location of the DISCO file. The 
/system/wsdlMap/disco/{any} (minOccurs=0 maxOccurs=unbounded) provides extensibility. 
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The /system/wsdlMap/wsil (minOccurs=0 maxOccurs=unbounded) element is used to specify 
the location of a WSIL file for this service. Multiple entries may exist pointing to the same file 
hosted in multiple locations, or to variations on the content within the WSIL files. The 
/system/wsdlMap/wsil/@wsilLocation (anyURI minOccurs=0 maxOccurs=l) attribute is aURI 
that specifies the location of the WSIL file. The /system/wsdlMap/wsil/{any} (minOccurs=0 
maxOccurs=unbounded) provides extensibility. 

wiylnbox /Domain Specific Methods 

The .NET Inbox service has seven domain-specific messages, including a mylnbox 
/sendMessage method, which sends a plain-text or fully MIME-encoded message from the 
user's account. If the optional, "saveSentMessage" is included, a copy of the sent message 
will be saved in the Sent Messages folder and the responseBody will include a header element 
with the new system-defined ID attribute. 

Another method is a mylnbox/sendMessageRequest, which is accessed using a request 
message. In response, this method may generate a response message or a SOAP Fault 
message. The following sample document fragments generally set forth the structure and 
meaning of the elements and attributes in the request and response messages. 

The following section describes the request message for this method: 

<m: sendMessageRequest 

xmlns:m="http://schemas.microsoft.coni/hs/200 1/1 0/mylnbox" 
xmlns:hs="http://schemas.microsoft.com/lis/2001/10/core">i..i 
<m:draftMessage select=" .."> 0 ..i 

<m:saveInFolder ref=="...">o..i</m:saveInFolder> 
</m:draftMessage> 
<m: rawMessage>o.. \ 
<m:messageStatus>o..i 
<m:saveInFolder ref^" ..'>cu</iri:saveInFolder> 



-82- 



<m:flag> 0 ..i 

<m : state> i . i </m : state> 

<m:title xml:lang=". dir=" ./X.i<Vm:title> 

<m:reminderDate>o. i </m: reminderDate> 

{any} 
</m:flag> 

</m:messageStatxis> 

<m:messageContent> 0 .. 1 

<m:cat ref="...' , >o..unbounded < /m:cat> 

<m:raw2822Content>i..i</m:raw2822Content> 

{any} 

</m:messageContent> 
</m:rawMessage> 
</m:sendMessageRequest> 
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The /sendMessageRequest (minOccurs=l maxOccurs=l) method is used to send a 
message from mylnbox. It takes a pointer to a draft message to send, or a raw message that 
represents a full RFC2822/Mime message. This method is accessed using a request message, 
and in response may generate a domain-specific response message, or may generate a SOAP 
fault message. The types used in these messages are fully specified in the service's schema 
document referenced above. 

The sendMessageRequest/draftMessage (minOccurs=0 maxOccurs=l) element is used 
to identify an existing draft to send. The /sendMessageRequest/draftMessage/@select (string 
minOccurs=l maxOccurs=l) item specifies an XPath expression that selects a set of nodes 
relative to the externally established context. The expression can never travel outside the 
node-set established by this externally established current context. The expression can match 
zero or more nodes, and the operation manipulates all selected nodes. The minOccurs and 
maxOccurs attributes are optional and place restrictions and limitations on the number of nodes 
selected. 
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The /sendMessageRequest/draftMessage/savelnFolder (minOccurs=0 maxOccurs=l) 
element defines the folder in which a copy of this message should be saved. The 
/sendMessageRequest/draftMessage/saveInFolder/@ref (minOccurs=0 maxOccurs= 1 ) 
uuidType is used to specify a universally unique identifier (UUID). 

The /sendMessageRequest/rawMessage (minOccurs=0 maxOccurs=l) element is used 
to specify a raw message to send. 

The /sendMessageRequest/rawMessage/messageStatus (minOccurs=0 maxOccurs=l) 
includes a The /sendMessageRequest/rawMessage/messageStatus/savelnFolder (minOccurs=0 
maxOccurs=l) element that defines the folder in which a copy of this message should be saved. 

The /sendMessageRequest/rawMessage/messageStatus/saveInFolder/@ref 
(minOccurs=0 maxOccurs=l) uuidType is used to specify a universally unique identifier 
(UUID). 

The /sendMessageRequest/rawMessage/messageStatus/flag (minOccurs=0 
maxOccurs=l) optional element defines the flag state of the message. It includes an {any} 
element that can be used for extensible flags. The 

/sendMessageRequest/rawMessage/messageStatus/flag/state (string minOccurs=l 
maxOccurs=l) field contains the state of a message flag. The 
/sendMessageRequest/rawMessage/messageStatus/flag/title (string minOccurs^l 
maxOccurs=l) field contains the client defined text of the flag. The 
/sendMessageRequest/rawMessage/messageStatus/flag/title/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
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of the content within this element. The 

/sendMessageRequest/rawMessage/messageStatus/flag/title/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and ltr (left to right). 

The /sendMessageRequest/rawMessage/messageStatus/flag/reminderDate (dateTime 
minOccurs=0 maxOccurs=l) field contains the client-defined reminder date of the flag. 

The /sendMessageRequest/rawMessage/messageStatus/flag/{any} (minOccurs=0 
maxOccurs=unbounded), if present, includes the 
/sendMessageRequest/rawMessage/messageStatus/{any} (minOccurs=0 
maxOccurs=unbounded) field, for extensibility. The 

/sendMessageRequest/rawMessage/messageContent (minOccurs=0 maxOccurs=l) field 
represents a complete RFC2822 / MIME message. The 
/sendMessageRequest/rawMessage/messageContent/cat (minOccurs=0 
maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing either a global category definition (in either the .NET Categories service system 
document or an external resource containing category definitions), or by referencing an 
identity-centered category definition in the content document of the .NET Categories service 
for a particular PUID. 

The /sendMessageRequest/rawMessage/messageContent/cat/@ref (anyURI 
minOccurs=l maxOccurs=l) attribute references a category definition (catDef) element using 
the rules outlined in the .NET Categories section, above. 



-85- 



The /sendMessageRequest/rawMessage/messageContent/raw2822Content 
(base64Binary minOccurs=l maxOccurs=l) field contains the complete RFC2822 / MIME 
content. The /sendMessageRequest/rawMessage/messageContent/{any} (minOccurs=0 
maxOccurs=unbounded) field provides for extensibility. 

Upon successful completion of a message request, a response message is generated by 
the sendMessageResponse method. The format of the response message is described in the 
following table: 

<m:sendMessageResponse selectedNodeCount=" .." status="..." 

xmlns:m="http://schemas. microsoft.com/hs/2001/10/mylnbox" 

xmlns:hs- 'http://schemas.microsoft.com/lis/200 1/1 0/core">i..i 

<m:newBlueId id="... ,, >i..i</m:newBlueId> 
</m:sendMessageResponse> 

The /sendMessageResponse (minOccurs=l maxOccurs=l) response is used to indicate 
the success of the operation as well as the new id associated with any messages that were 
saved as a result of this method. The /sendMessageResponse/@selectedNodeCount (int 
minOccurs=0 maxOccurs=l) attribute is used to return the number of selected nodes, selected 
by the corresponding data language operation. 

The /sendMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If the status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 
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The/sendMessageResponse/newBlueld (minOccurs=l maxOccurs=l) field contains 
the new identifier of the message that was saved in mylnbox. The 

/sendMessageResponse/newBlueId/@id (minOccurs=l maxOccurs=l) attribute specifies the 
ID of the deleted item. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "s:mustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

The mylnbox/saveMessage allows a client to add either a complete rfc822 local 
message to .NET Inbox or to save a draft message. 

The mylnbox/saveMessageRequest method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following sample 
document fragments and description below illustrate the structure and meaning of the elements 
and attributes in the request and response messages: 



<m:saveMessageRequest 

xmlns:m="http://schemas.microsoft.conl/lls/2001/10/myInbox 5, 
xmlns :hs="http ://schemas . microsoft . com/hs/20 0 1 / 1 0/core"> i .. i 
<m:completeLocalMessage>o.. i 
<m:messageStatus>o..i 

<m: isRead>i i </m : isRead> 
<m:folder ref="...">i..i</m:folder> 
<m:flag> 0 ..i 

<m : state> i . . i </m : s t ate> 
<m:title xml:lang=".." dir="...">i..i</m:title> 
<m: reminderDat e> 0 . . i </m : rem i nderDate> 
{any} 
</m:flag> 

<m:state>i..i</m:state> 

{any} 
</m:messageStatus> 
<m:messageContent> 0 ..i 
<m:cat ref= c< . . . ?> >o„unbounded < /m:cat> 
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<m:raw2822Content>,..,</m:raw2822Content> 
{any} 

</m:messageContent> 
</m:completeLocalMessage> 
</m:saveMessageRequest> 



The /saveMessageRequest (minOccurs=l maxOccurs=l) method is used to save a local 
message (for example in a PST file) into mylnbox. This method is accessed using a request 
message, and in response may generate a domain-specific response message, or may generate a 
5 SOAP fault message. The types used in these messages are fully specified in the services base 
schema document referenced above. 
H The /saveMessageRequest/completeLocalMessage (minOccurs^O maxOccurs=l) 

If* element represents a complete local message to add to mylnbox. The 

aU 

|fj /saveMessageRequest/completeLocalMessage/messageStatus (minOccurs=0 maxOccurs=l), if 

m 

|y 10 present, includes the /saveMessageRequest/completeLocalMessage/messageStatus/isRead 
(boolean minOccurs=l maxOccurs=l) element, which defines the read/unread state of the 

9 

||j message and can be modified. 

l| The/saveMessageRequest/completeLocalMessage/messageStatus/folder (minOccurs=l 

maxOccurs=l) element defines the single folder that this message logically belongs to. The 
15 /saveMessageRequest/completeLocalMessage/messageStatus/folder/@ref (minOccurs=0 
maxOccurs=l) uuidType is used to specify a universally unique identifier (UUID). The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag (minOccurs=0 
maxOccurs=l) optional element defines the flag state of the message. It includes an {any} 
element that can be used for extensible flags. 
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The /saveMessageRequest/completeLocalMessage/messageStatus/flag/state (string 
minOccurs=l maxOccurs=l) field contains the state of a message flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/title (string minOccurs=l 
maxOccurs=l) field contains the client-defined text of the flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/titIe/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/saveMessageRequest/completeLocalMessage/messageStatus/flag/title/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and ltr (left to right). The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/reminderDate (dateTime 
minOccurs=0 maxOccurs=l) field contains the client-defined reminder date of the flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/{any} (minOccurs=0 
maxOccurs=unbounded) field provides extensibility, as described above. 

The /saveMessageRequest/completeLocalMessage/messageStatus/state (string 
minOccurs=l maxOccurs=l) element defines the sent/received state of the message. The 
/saveMessageRequest/completeLocalMessage/messageStatus/{any} (minOccurs=0 
maxOccurs=unbounded) field provides for extensibility. 

The /saveMessageRequest/completeLocalMessage/messageContent (minOccurs=0 
maxOccurs=l) field represents a complete RFC2822 / MIME message. The 
/saveMessageRequest/completeLocalMessage/messageContent/cat (minOccurs=0 
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maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing either a global category definition (in either the .NET Categories service system 
document or an external resource containing category definitions), or by referencing an 
identity-centered category definition in the content document of the .NET Categories service 
for a particular PUK). 

The /saveMessageRequest/completeLocalMessage/messageContent/cat/@ref (anyURI 
minOccurs=l maxOccurs=l) attribute references a category definition (catDef) element using 
the rules outlined in the .NET Categories (MyCategories) section, above. The 
/saveMessageRequest/completeLocalMessage/messageContent/raw2822Content 
(base64Binary minOccurs=l maxOccurs=l) field contains the complete RFC2822 / MIME 
content. The /saveMessageRequest/completeLocalMessage/messageContent/{any} 
(minOccurs=0 maxOccurs=unbounded) field provides for extensibility. 

Upon successful completion of this method, a response message is generated. The 

format of the response message, mylnbox/saveMessageResponse, is described next. To this 

end, the document fragment in the table below and the various meanings are described: 

<m:saveMessageResponse selectedNodeCount="..." status=" 
xmlns:m="http://schemas.microsoft.com/lis/200 1/1 0/mylnbox" 
xmlns:hs="http://schemas.microsoft.coni/lis/200 1/1 0/core">i.,i 
<m:newBlueId id=" ..">i..i</m:newBlueId> 
</m:saveMessageResponse> 

The /saveMessageResponse (minOccurs=l maxOccurs=l) response contains a 
newBlueld for each message that was successfully saved. The 

/saveMessageResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute is 
used to return the number of selected nodes, selected by the corresponding data language 



-90- 



operation. The /saveMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If the status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 

The/saveMessageResponse/newBlueld (minOccurs=l maxOccurs=l) element 
represents the new or saved message. The /saveMessageResponse/newBlueId/@id 
(minOccurs=l maxOccurs=l) attribute specifies the ID of the deleted item. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "s:mustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

The mylnbox/copyMessage method allows clients to copy one or more messages into a 
folder. The message data, (including attachments) is copied and new message headers are 
returned with unique header ID values. 
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The mylnbox/copyMessageRequest method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following sample 
document fragments and following description illustrate the structure and meaning of the 
elements and attributes in the request and response messages: 



<m:copyMessageRequest useClientIds="..." 

xmlns:m="http://schemas.microsoft.corn/hs/2001/10/mylnbox'' 

xmlns:hs="http://schemas.microsoft.coni/hs/2001/10/core'>i..i 

<m:message select=" .." copyAsDraft=" . " clientld- c ...' > >i.. U nbounded < /m:message> 

<m:targetFolder ref=" . . "> i .. i </m: targetFolder> 
</m:copyMessageRequest> 

5 

The /copyMessageRequest (minOccurs=l maxOccurs=l) message allows clients to 

P copy one or more messages to a folder. The message data (including attachments) is copied 

C3 

[W and new message messages are returned with unique message ID values. This element 

\* 
f. i% 

;{ 3 ! encapsulates the arguments to the copyMessage method. It contains a message element and a 

ia 

B 10 targetFolder element. 

I* 

□ The /copyMessageRequest/@useClientIds (boolean minOccurs=0 maxOccurs=l) 

f U optional attribute, if present, specifies that each message element's id attribute will be used as 

P 

the new id. The /copyMessageRequest/message (minOccurs=l maxOccurs=unbounded) 
element contains a select statement that contains an XPATH expression indicating a message 
1 5 for which to copy the associated message. 

The/copyMessageRequest/message/@select (string minOccurs=l maxOccurs=l) field 
contains the location of the message (which is associated with the message) to copy, e.g., 
/myInbox/message[@id- '"] . 
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The /copyMessageRequest/message/@copyAsDraft (boolean minOccurs=0 
maxOccurs=l), if this value is present and set to true, causes the message to be copied as a 
draft into the target folder. 

The /copyMessageRequest/message/@clientId (minOccurs=0 maxOccurs=l) attribute 
specifies that the server should use the value of this attribute as the id of the new message; 
useClientlds should be present on the copyRequest element and set to true 

The/copyMessageRequest/targetFolder (minOccurs=l maxOccurs=l) field contains 
the id of an existing folder to copy the message(s) to. 

The /copyMessageRequest/targetFolder/@ref (minOccurs=0 maxOccurs=l) uuidType 
is used to specify a universally unique identifier (UUID). 

Upon successful completion of this method, a response message, 
mylnbox/copyMessageResponse, is generated. The format of the response message is 
described next: 

<m:copyMessageResponse selectedNodeCount-'. . ." status- . 

xmlns:m- c http://schemas.microsoft.com/lis/2001/10/mylnbox" 

xmlns:hs="http://schemas .microsoft xom/lis/2 00 1 / 1 0/core"> i . i 

<m:newBlueId id=" . ">i..i</m:ne\vBlueId> 
</m:copyMessageResponse> 

The /copyMessageResponse (minOccurs=l maxOccurs=l) response from 
copyMessage includes a newBlueld element for each successfully copied message. The 
/copyMessageResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute is 
used to return the number of selected nodes, selected by the corresponding data language 
operation. 
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The /copyMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If the status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 

The/copyMessageResponse/newBlueld (minOccurs=l maxOccurs=l) element is 
typically found in the body of an insertResponse, updateResponse, or replaceResponse to 
indicate that a new ID value was generated by the corresponding request operation. 
Applications, in response, need to walk through their changes in order, and apply the returned 
ID to any cached value of the node they just inserted. Only a new ID generation triggers this, 
so in the case of an ID-preserving replaceRequest, the root of the replacement never generates 
one of these, but an inner xdb:blue does. 

The /copyMessageResponse/newBlueId/@id (minOccurs=l maxOccurs=l) attribute 
specifies the ID of the deleted item. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "s:mustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

As can be seen from the foregoing detailed description, there is provided a schema- 
based inbox service that allows users to access their data based on their identities and 
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corresponding roles with respect to the data. The schema-based inbox service provides Inbox 
data access independent of the application program and device, and in a centrally-accessible 
location such as the Internet. The schema-based inbox service is extensible to handle extended 
contact information. 



constructions, certain illustrated embodiments thereof are shown in the drawings and have 
been described above in detail. It should be understood, however, that there is no intention to 
limit the invention to the specific forms disclosed, but on the contrary, the intention is to cover 
all modifications, alternative constructions, and equivalents falling within the spirit and scope 

13 

Q 10 of the invention. 
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While the invention is susceptible to various modifications and alternative 




-95 - 



